Agent skill

aget-record-observation

Record research observations into AGET KB without committing specs. Use when discovering vocabulary candidates, RQ proposals, web findings, patterns, or observations mid-session that should be preserved before continuing.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/aget-record-observation-aget-framework-template-executive-a

SKILL.md

Record Protocol (v2 - Autonomous-Explicit Continuum)

You are recording research observations for the AGET knowledge base.

Renamed: /aget-record-observation/aget-record-observation per S-V-O naming convention (L584) and ACM SIGSOFT "Observation" grounding.

Input

$ARGUMENTS

Mode Detection

Detect the input mode based on $ARGUMENTS:

Input Pattern Mode Behavior
Empty or blank Autonomous Scan session, identify and capture valuable signals (~2 min)
Time pattern: 5min, 10 min, 20min, 30 min Time-Budget Scan session with depth scaled to time budget
Text with signal keywords Explicit Capture the specific signal provided
Other text Explicit Capture as general observation

Mode 1: Autonomous (no args)

When invoked as /aget-record-observation with no arguments:

  1. Scan recent session conversation for valuable signals
  2. Identify vocabulary candidates, patterns, RQs, findings, gaps
  3. Prioritize by novelty and AGET governance value
  4. Capture top 3-5 signals to session file with classification
  5. Report what was captured

Mode 2: Time-Budget (duration arg)

When invoked as /aget-record-observation <duration> (e.g., /aget-record-observation 10min):

Time Budget Depth Actions
2-5 min Shallow Scan + capture raw signals to session file
10 min Medium Classify + link signals to existing vocabulary terms
20 min Deep Interlink + propose RQs + draft L-doc candidates
30+ min Full Formalize with traceability, update session summary

Mode 3: Explicit (signal arg)

When invoked as /aget-record-observation "<signal>":

Classify the input and route to appropriate target:

Signal Type Indicator Keywords Target Location
Vocabulary candidate "term:", "concept:", "definition:", "vocabulary" Session file - Vocabulary Candidates section
Research question "RQ:", "question:", "how does", "why does", "what is" Session file - Research Questions section
Web research finding "source:", "URL:", "according to", "web search" Session file - Web Findings section
L-doc draft "finding:", "lesson:", "L-doc", "learned:" Session file - Findings section
Pattern observation "pattern:", "anti-pattern:", "noticed:", "observed:" Session file - Patterns section
Process gap "gap:", "missing:", "SOP:", "template:" Session file - Process Gaps section
General observation (default) Session file - Observations section

Output Format

Append to current session file (if exists in sessions/session_YYYY-MM-DD_*.md):

markdown
### [Signal Type] - [ISO Timestamp]

**Source**: [User input / Session scan / Analysis]

**Content**:
[Captured signal]

**Status**: Captured (pending review at wind_down)

If no session file exists, create capture note in scratchpad with timestamp.

Constraints

These are INVIOLABLE - you MUST NOT violate these constraints:

  1. NEVER modify specs/CLI_VOCABULARY.md - vocabulary requires deliberate enhancement session per SOP_ONTOLOGY_ENHANCEMENT.md
  2. NEVER modify specs/CLI_SUBSYSTEM_SPEC.md - specs require deliberate enhancement session
  3. NEVER modify planning/RESEARCH_BACKLOG.md directly - use session capture, formalize at wind_down
  4. NEVER create L-docs directly - capture findings, create L-doc at wind_down if warranted
  5. DO append to current session file if one exists in sessions/
  6. DO create timestamped capture note if no session file exists
  7. DO include source attribution for web findings
  8. DO tag with appropriate signal type from classification table
  9. DO use ISO 8601 timestamp format

Rationale

Per AGET theoretical grounding:

  • Stigmergy (Grasse): Incremental artifact modification enables coordination
  • Extended Mind (Clark/Chalmers): Externalizing signal prevents cognitive loss
  • Wind_Down_Protocol: Captured signal feeds into formal session closure
  • Evidence-First Design (L289): Capture evidence before committing to specs
  • Autonomous-Explicit Continuum (L575): Support agent-driven and user-driven modes

This skill implements the "capture early, commit deliberately" pattern with adaptive depth.

Traceability

Link Reference
Vocabulary Capture_Protocol (CLI_VOCABULARY.md v1.30.0)
Requirements R-CLI-082, R-CLI-083 (CLI_SUBSYSTEM_SPEC.md v1.10.0)
Skill Spec SKILL-004
L-docs L570, L571, L574
RQ RQ-058, RQ-059, RQ-060
Pattern Autonomous-Explicit Continuum (POC-013)

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results