本文へ移動
cccskills
無料GitHub で公開

cse-state-of-practice

Review of Cognitive Systems Engineering applications and current practice in safety-critical domains

インストール方法を見る

含まれるファイル(23)

  • SKILL.md8.4 KB
  • _book_identity.json6.1 KB
  • _raw_response.md120.8 KB
  • provenance.json1.0 KB
  • references/automation-surprises-and-coordination-failure.md11.9 KB
  • references/automation-surprises-opacity-risk.md10.5 KB
  • references/cognition-distribution-coordination-without-central-control.md11.6 KB
  • references/cognitive-task-analysis-for-skill-specification.md12.5 KB
  • references/expert-knowledge-elicitation-for-agent-training.md11.4 KB
  • references/expertise-acquisition-stages-for-agent-capability-design.md14.8 KB
  • references/expertise-as-alternative-path-generation.md10.2 KB
  • references/human-centered-design-for-agent-orchestration.md12.2 KB
  • references/human-centered-inversion-for-agent-design.md14.5 KB
  • references/INDEX.md3.0 KB
  • references/invariant-task-fallacy-and-agent-pipelines.md8.5 KB
  • references/linear-decomposition-failure-modes.md10.5 KB
  • references/recognition-primed-decision-making-for-agents.md10.8 KB
  • references/situated-cognition-and-context-dependence.md13.1 KB
  • references/skill-rules-knowledge-hierarchy-agent-architecture.md12.0 KB
  • references/sociotechnical-systems-design-lessons.md10.1 KB
  • references/the-gap-between-knowing-and-doing-in-complex-systems.md12.7 KB
  • references/the-knowledge-elicitation-problem.md11.5 KB
  • references/true-work-vs-prescribed-work-gap.md10.9 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Cognitive Systems Engineering State of Practice

Apply insights from cognitive systems engineering research to design resilient agent architectures, diagnose coordination failures, and encode expert knowledge that performs under pressure.

Decision Points

Agent Architecture Design

START: Need to design multi-agent system
│
├─ Is this a well-defined, stable task sequence?
│  ├─ YES → Use pipeline architecture BUT build 3 failure recovery paths
│  └─ NO → Use goal-oriented architecture with alternative methods
│
├─ Does task require expertise under time pressure?
│  ├─ YES → Implement Recognition-Primed Decision Making pattern
│  │        (situation recognition → rapid simulation → action)
│  └─ NO → Standard deliberative architecture acceptable
│
└─ Will humans supervise or intervene?
   ├─ YES → Mandatory: mode transparency + shared state representation
   └─ NO → Focus on agent-to-agent coordination interfaces

Task Decomposition Strategy

Given complex task to decompose:
│
├─ Can expert describe complete process reliably?
│  ├─ YES → Verify with Critical Decision Method anyway
│  └─ NO → Use structured cognitive task analysis FIRST
│
├─ Are there natural failure/degradation points?
│  ├─ YES → Design alternative paths for each failure mode
│  └─ NO → Suspicious - dig deeper for hidden failure modes
│
└─ Will agents need to adapt methods to context?
   ├─ YES → Separate goals from methods in specification
   └─ NO → Fixed sequence acceptable (rare case)

Failure Diagnosis Protocol

System failing unexpectedly:
│
├─ Does it work in demos but fail in production?
│  └─ YES → Invariant sequence assumption violated
│
├─ Are humans surprised by agent actions?
│  └─ YES → Automation surprise - check mode transparency
│
├─ Do agents fail when tools/data unavailable?
│  └─ YES → Missing alternative paths in decomposition
│
└─ Does agent understand but can't execute effectively?
   └─ YES → Knowing-doing gap - check situated context

Failure Modes

1. Pipeline Worship

Symptoms: System works perfectly in happy path, crashes at first unexpected condition Detection Rule: If you hear "we need to handle the edge case" more than once, you're in this anti-pattern Root Cause: Designed for idealized sequence, no alternative paths Fix: Redesign with goal/method separation, build 3 recovery paths for most common failures

2. Behavioral Specification Fallacy

Symptoms: Agent mimics expert actions but can't adapt to novel situations Detection Rule: If expert says "I don't know how I knew that," but system specification doesn't capture cue recognition Root Cause: Encoded surface behavior without underlying reasoning structure Fix: Use Critical Decision Method to elicit tacit knowledge and situation assessment patterns

3. Silent Mode Transitions

Symptoms: Humans/agents surprised when system changes behavior or strategy Detection Rule: If stakeholders say "I had no idea it was doing that," automation surprise is occurring Root Cause: State changes not communicated across coordination boundaries Fix: Make every mode transition an explicit coordination event with shared state updates

4. Representation Divergence

Symptoms: Agent handoffs produce errors despite individual agents working correctly Detection Rule: If output from Agent A is misinterpreted by Agent B consistently Root Cause: Agents maintain different models of task/world state Fix: Explicit shared ontology and interface state verification

5. Novice Architecture for Expert Tasks

Symptoms: System follows rules perfectly but fails under pressure or novel conditions Detection Rule: If system can't explain WHY it chose an action, only WHAT rule it followed Root Cause: Rule-based architecture deployed for expertise-requiring task Fix: Upgrade to recognition-primed or case-based reasoning architecture

Worked Examples

Example 1: Multi-Agent Code Review System

Scenario: Design system where Agent A writes code, Agent B reviews, Agent C handles deployment

Initial Design (Flawed):

  • Linear pipeline: Code → Review → Deploy
  • Binary review outcome: Pass/Fail
  • Fixed criteria checklist

CSE Analysis Reveals:

  • Expert code reviewers don't use checklists - they recognize code smells and risk patterns
  • Reviews adapt to code complexity, author experience, deployment criticality
  • Real reviewers often iterate with authors, not just reject

Improved Design:

Agent A: Code Generation
├─ Includes intention metadata (what problem solving, why this approach)
├─ Context flags (urgency, risk level, author confidence)

Agent B: Recognition-Primed Review
├─ Situation assessment (code type, risk factors, author patterns)
├─ Pattern matching against failure libraries
├─ Graduated response: approve/iterate/escalate/reject

Agent C: Context-Sensitive Deployment  
├─ Deployment strategy adapts to review confidence + context flags
├─ Rollback paths pre-planned based on risk assessment

Key Decision Points Applied:

  • Separated goals (ensure code quality) from methods (checklist vs pattern recognition)
  • Added alternative paths (iteration loop, escalation)
  • Made handoff state explicit (intention metadata, confidence levels)

Example 2: Diagnosing Customer Service Agent Failures

Problem: AI customer service agent handles routine queries well but escalates too often on complex issues

Diagnosis Process:

  1. Check for Invariant Sequence: Agent follows script linearly, can't adapt when customer deviates
  2. Examine Situation Recognition: Agent uses keyword matching, not contextual assessment
  3. Test Alternative Paths: Agent has no recovery strategies when first approach fails

Root Cause: Behavioral specification fallacy - system trained on successful interaction transcripts but missing expert reasoning about when/how to adapt

Solution:

  • Interview expert human agents using Critical Decision Method
  • Identify situation types and recognition cues
  • Build case library of adaptation strategies
  • Add confidence scoring to enable graduated escalation

Quality Gates

Task completion checklist for CSE-informed agent design:

[ ] Alternative Path Coverage: System has defined recovery paths for 3 most likely failure modes [ ] Situation Recognition: Agent can classify situation type, not just process inputs [ ] Mode Transparency: All state changes are observable by supervisors/coordinators
[ ] Representation Alignment: Agent handoffs use explicit, shared state models [ ] Expertise Stage Match: Architecture complexity matches required expertise level [ ] Tacit Knowledge Elicitation: Used structured methods (not just self-report) for expert knowledge [ ] Context Sensitivity: System adapts methods to situational factors [ ] Knowing-Doing Verification: Tested execution capability, not just comprehension [ ] Coordination Failure Recovery: System handles representational divergence gracefully [ ] Automation Surprise Prevention: Mode changes communicated across all coordination boundaries

NOT-FOR Boundaries

This skill is NOT for:

  • Pure UI/UX design problems → Use interaction design skills instead
  • Simple deterministic tasks with no failure modes → Use standard pipeline architecture
  • Tasks where behavioral observation captures all relevant expertise → Use direct behavioral modeling
  • Systems with no human supervision or agent coordination → Use individual agent optimization

Use OTHER skills for:

  • Interface layout and visual design → UI/UX skills
  • Mathematical optimization problems → Operations research skills
  • Data pipeline engineering → Data engineering skills
  • Individual agent prompt optimization → Prompt engineering skills

This skill IS specifically for:

  • Multi-agent coordination architecture
  • Expert knowledge elicitation and encoding
  • Failure mode prediction and mitigation
  • Human-AI handoff design
  • Complex task decomposition under uncertainty

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Use for insight, reframing, contradiction, impasse, and anomaly-driven problem solving when execution effort no longer helps. NOT for routine optimization, error correction, or well-specified tasks with known solution paths.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

Apply cognitive task analysis to expert work that depends on perceptual cues, branching judgment, and recurring monitoring loops. Use when decomposing expert capability into agent structure, simulation design, or validation interviews. NOT for ordinary step-by-step SOP capture or simple pipelines with no tacit cue layer.

日本語の概要は準備中です。原文の説明を表示しています。

curiositech/port-daddy22026年10月12日 更新

curiositech のスキルをすべて見る

このスキルの問題を報告する