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:
- Scan recent session conversation for valuable signals
- Identify vocabulary candidates, patterns, RQs, findings, gaps
- Prioritize by novelty and AGET governance value
- Capture top 3-5 signals to session file with classification
- 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):
### [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:
- NEVER modify
specs/CLI_VOCABULARY.md - vocabulary requires deliberate enhancement session per SOP_ONTOLOGY_ENHANCEMENT.md
- NEVER modify
specs/CLI_SUBSYSTEM_SPEC.md - specs require deliberate enhancement session
- NEVER modify
planning/RESEARCH_BACKLOG.md directly - use session capture, formalize at wind_down
- NEVER create L-docs directly - capture findings, create L-doc at wind_down if warranted
- DO append to current session file if one exists in
sessions/
- DO create timestamped capture note if no session file exists
- DO include source attribution for web findings
- DO tag with appropriate signal type from classification table
- 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) |
1---2name: aget-record-observation3description: 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.4---5
6## Record Protocol (v2 - Autonomous-Explicit Continuum)
7
8You are recording research observations for the AGET knowledge base.
9
10**Renamed**: `/aget-record-observation` → `/aget-record-observation` per S-V-O naming convention (L584) and ACM SIGSOFT "Observation" grounding.
11
12### Input
13
14$ARGUMENTS
15
16### Mode Detection
17
18Detect the input mode based on $ARGUMENTS:
19
20| Input Pattern | Mode | Behavior |
21|---------------|------|----------|
22| Empty or blank | **Autonomous** | Scan session, identify and capture valuable signals (~2 min) |
23| Time pattern: `5min`, `10 min`, `20min`, `30 min` | **Time-Budget** | Scan session with depth scaled to time budget |
24| Text with signal keywords | **Explicit** | Capture the specific signal provided |
25| Other text | **Explicit** | Capture as general observation |
26
27### Mode 1: Autonomous (no args)
28
29When invoked as `/aget-record-observation` with no arguments:
30
311. **Scan** recent session conversation for valuable signals
322. **Identify** vocabulary candidates, patterns, RQs, findings, gaps
333. **Prioritize** by novelty and AGET governance value
344. **Capture** top 3-5 signals to session file with classification
355. **Report** what was captured
36
37### Mode 2: Time-Budget (duration arg)
38
39When invoked as `/aget-record-observation <duration>` (e.g., `/aget-record-observation 10min`):
40
41| Time Budget | Depth | Actions |
42|-------------|-------|---------|
43| 2-5 min | Shallow | Scan + capture raw signals to session file |
44| 10 min | Medium | Classify + link signals to existing vocabulary terms |
45| 20 min | Deep | Interlink + propose RQs + draft L-doc candidates |
46| 30+ min | Full | Formalize with traceability, update session summary |
47
48### Mode 3: Explicit (signal arg)
49
50When invoked as `/aget-record-observation "<signal>"`:
51
52Classify the input and route to appropriate target:
53
54| Signal Type | Indicator Keywords | Target Location |
55|-------------|-------------------|-----------------|
56| Vocabulary candidate | "term:", "concept:", "definition:", "vocabulary" | Session file - Vocabulary Candidates section |
57| Research question | "RQ:", "question:", "how does", "why does", "what is" | Session file - Research Questions section |
58| Web research finding | "source:", "URL:", "according to", "web search" | Session file - Web Findings section |
59| L-doc draft | "finding:", "lesson:", "L-doc", "learned:" | Session file - Findings section |
60| Pattern observation | "pattern:", "anti-pattern:", "noticed:", "observed:" | Session file - Patterns section |
61| Process gap | "gap:", "missing:", "SOP:", "template:" | Session file - Process Gaps section |
62| General observation | (default) | Session file - Observations section |
63
64### Output Format
65
66Append to current session file (if exists in `sessions/session_YYYY-MM-DD_*.md`):
67
68```markdown
69### [Signal Type] - [ISO Timestamp]
70
71**Source**: [User input / Session scan / Analysis]
72
73**Content**:
74[Captured signal]
75
76**Status**: Captured (pending review at wind_down)
77```
78
79If no session file exists, create capture note in scratchpad with timestamp.
80
81### Constraints
82
83These are INVIOLABLE - you MUST NOT violate these constraints:
84
851. **NEVER** modify `specs/CLI_VOCABULARY.md` - vocabulary requires deliberate enhancement session per SOP_ONTOLOGY_ENHANCEMENT.md
862. **NEVER** modify `specs/CLI_SUBSYSTEM_SPEC.md` - specs require deliberate enhancement session
873. **NEVER** modify `planning/RESEARCH_BACKLOG.md` directly - use session capture, formalize at wind_down
884. **NEVER** create L-docs directly - capture findings, create L-doc at wind_down if warranted
895. **DO** append to current session file if one exists in `sessions/`
906. **DO** create timestamped capture note if no session file exists
917. **DO** include source attribution for web findings
928. **DO** tag with appropriate signal type from classification table
939. **DO** use ISO 8601 timestamp format
94
95### Rationale
96
97Per AGET theoretical grounding:
98- **Stigmergy** (Grasse): Incremental artifact modification enables coordination
99- **Extended Mind** (Clark/Chalmers): Externalizing signal prevents cognitive loss
100- **Wind_Down_Protocol**: Captured signal feeds into formal session closure
101- **Evidence-First Design** (L289): Capture evidence before committing to specs
102- **Autonomous-Explicit Continuum** (L575): Support agent-driven and user-driven modes
103
104This skill implements the "capture early, commit deliberately" pattern with adaptive depth.
105
106### Traceability
107
108| Link | Reference |
109|------|-----------|
110| Vocabulary | Capture_Protocol (CLI_VOCABULARY.md v1.30.0) |
111| Requirements | R-CLI-082, R-CLI-083 (CLI_SUBSYSTEM_SPEC.md v1.10.0) |
112| Skill Spec | SKILL-004 |
113| L-docs | L570, L571, L574 |
114| RQ | RQ-058, RQ-059, RQ-060 |
115| Pattern | Autonomous-Explicit Continuum (POC-013) |
majiayu000