create-claude-context 1.0.0 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +169 -146
- package/bin/create-claude-context.js +75 -61
- package/lib/ai-orchestrator.js +423 -0
- package/lib/call-tracer.js +444 -0
- package/lib/detector.js +456 -373
- package/lib/environment-detector.js +239 -0
- package/lib/index.js +271 -170
- package/lib/installer.js +371 -362
- package/lib/placeholder.js +269 -208
- package/lib/prompts.js +287 -287
- package/lib/spinner.js +60 -60
- package/lib/static-analyzer.js +729 -0
- package/lib/template-populator.js +835 -0
- package/lib/validate.js +147 -147
- package/package.json +59 -59
- package/templates/CLAUDE.md.template +235 -235
- package/templates/base/README.md +257 -257
- package/templates/base/RPI_WORKFLOW_PLAN.md +320 -320
- package/templates/base/agents/api-developer.md +76 -76
- package/templates/base/agents/context-engineer.md +525 -525
- package/templates/base/agents/core-architect.md +76 -76
- package/templates/base/agents/database-ops.md +76 -76
- package/templates/base/agents/deployment-ops.md +76 -76
- package/templates/base/agents/integration-hub.md +76 -76
- package/templates/base/analytics/README.md +114 -114
- package/templates/base/automation/config.json +58 -0
- package/templates/base/automation/generators/code-mapper.js +308 -0
- package/templates/base/automation/generators/index-builder.js +321 -0
- package/templates/base/automation/hooks/post-commit.sh +83 -0
- package/templates/base/automation/hooks/pre-commit.sh +103 -0
- package/templates/base/ci-templates/README.md +108 -108
- package/templates/base/ci-templates/github-actions/context-check.yml +144 -144
- package/templates/base/ci-templates/github-actions/validate-docs.yml +105 -105
- package/templates/base/commands/analytics.md +238 -238
- package/templates/base/commands/auto-sync.md +172 -0
- package/templates/base/commands/collab.md +194 -194
- package/templates/base/commands/help.md +450 -450
- package/templates/base/commands/rpi-implement.md +115 -115
- package/templates/base/commands/rpi-plan.md +93 -93
- package/templates/base/commands/rpi-research.md +88 -88
- package/templates/base/commands/session-resume.md +144 -0
- package/templates/base/commands/session-save.md +112 -0
- package/templates/base/commands/validate-all.md +77 -77
- package/templates/base/commands/verify-docs-current.md +86 -86
- package/templates/base/config/base.json +57 -57
- package/templates/base/config/environments/development.json +13 -13
- package/templates/base/config/environments/production.json +17 -17
- package/templates/base/config/environments/staging.json +13 -13
- package/templates/base/config/local.json.example +21 -21
- package/templates/base/context/.meta/generated-at.json +18 -0
- package/templates/base/context/ARCHITECTURE_SNAPSHOT.md +156 -156
- package/templates/base/context/CODE_TO_WORKFLOW_MAP.md +94 -94
- package/templates/base/context/FILE_OWNERSHIP.md +57 -0
- package/templates/base/context/INTEGRATION_POINTS.md +92 -0
- package/templates/base/context/KNOWN_GOTCHAS.md +195 -195
- package/templates/base/context/TESTING_MAP.md +95 -0
- package/templates/base/context/WORKFLOW_INDEX.md +129 -129
- package/templates/base/context/workflows/WORKFLOW_TEMPLATE.md +294 -294
- package/templates/base/indexes/agents/CAPABILITY_MATRIX.md +255 -255
- package/templates/base/indexes/agents/CATEGORY_INDEX.md +44 -44
- package/templates/base/indexes/code/CATEGORY_INDEX.md +38 -38
- package/templates/base/indexes/routing/CATEGORY_INDEX.md +39 -39
- package/templates/base/indexes/search/CATEGORY_INDEX.md +39 -39
- package/templates/base/indexes/workflows/CATEGORY_INDEX.md +38 -38
- package/templates/base/knowledge/README.md +98 -98
- package/templates/base/knowledge/sessions/README.md +88 -88
- package/templates/base/knowledge/sessions/TEMPLATE.md +150 -150
- package/templates/base/knowledge/shared/decisions/0001-adopt-context-engineering.md +144 -144
- package/templates/base/knowledge/shared/decisions/README.md +49 -49
- package/templates/base/knowledge/shared/decisions/TEMPLATE.md +123 -123
- package/templates/base/knowledge/shared/patterns/README.md +62 -62
- package/templates/base/knowledge/shared/patterns/TEMPLATE.md +120 -120
- package/templates/base/plans/PLAN_TEMPLATE.md +250 -250
- package/templates/base/research/RESEARCH_TEMPLATE.md +153 -153
- package/templates/base/schemas/agent.schema.json +141 -141
- package/templates/base/schemas/anchors.schema.json +54 -0
- package/templates/base/schemas/automation.schema.json +93 -0
- package/templates/base/schemas/command.schema.json +134 -134
- package/templates/base/schemas/hashes.schema.json +40 -0
- package/templates/base/schemas/manifest.schema.json +117 -117
- package/templates/base/schemas/plan.schema.json +136 -136
- package/templates/base/schemas/research.schema.json +115 -115
- package/templates/base/schemas/roles.schema.json +34 -0
- package/templates/base/schemas/session.schema.json +77 -0
- package/templates/base/schemas/settings.schema.json +244 -244
- package/templates/base/schemas/staleness.schema.json +53 -0
- package/templates/base/schemas/team-config.schema.json +42 -0
- package/templates/base/schemas/workflow.schema.json +126 -126
- package/templates/base/session/checkpoints/.gitkeep +2 -0
- package/templates/base/session/current/state.json +20 -0
- package/templates/base/session/history/.gitkeep +2 -0
- package/templates/base/settings.json +3 -57
- package/templates/base/standards/COMPATIBILITY.md +219 -219
- package/templates/base/standards/EXTENSION_GUIDELINES.md +280 -280
- package/templates/base/standards/QUALITY_CHECKLIST.md +211 -211
- package/templates/base/standards/README.md +66 -66
- package/templates/base/sync/anchors.json +6 -0
- package/templates/base/sync/hashes.json +6 -0
- package/templates/base/sync/staleness.json +10 -0
- package/templates/base/team/README.md +168 -168
- package/templates/base/team/config.json +79 -79
- package/templates/base/team/roles.json +145 -145
- package/templates/base/tools/bin/claude-context.js +151 -151
- package/templates/base/tools/lib/anchor-resolver.js +276 -0
- package/templates/base/tools/lib/config-loader.js +363 -363
- package/templates/base/tools/lib/detector.js +350 -350
- package/templates/base/tools/lib/diagnose.js +206 -206
- package/templates/base/tools/lib/drift-detector.js +373 -0
- package/templates/base/tools/lib/errors.js +199 -199
- package/templates/base/tools/lib/index.js +36 -24
- package/templates/base/tools/lib/init.js +192 -192
- package/templates/base/tools/lib/logger.js +230 -230
- package/templates/base/tools/lib/placeholder.js +201 -201
- package/templates/base/tools/lib/session-manager.js +354 -0
- package/templates/base/tools/lib/validate.js +521 -521
- package/templates/base/tools/package.json +49 -49
|
@@ -1,115 +1,115 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: rpi-implement
|
|
3
|
-
version: "1.0.0"
|
|
4
|
-
description: "RPI Implement Phase: Execute plan with atomic changes and continuous testing"
|
|
5
|
-
category: "rpi-orchestration"
|
|
6
|
-
rpi_phase: "implement"
|
|
7
|
-
context_budget_estimate: "60K tokens"
|
|
8
|
-
typical_context_usage: "30%"
|
|
9
|
-
prerequisites:
|
|
10
|
-
- "Plan document exists in .claude/plans/active/"
|
|
11
|
-
- "Plan has been approved by human"
|
|
12
|
-
- "Git branch is clean"
|
|
13
|
-
- "All tests currently passing"
|
|
14
|
-
outputs:
|
|
15
|
-
- "Implemented feature/fix"
|
|
16
|
-
- "Updated documentation with new line numbers"
|
|
17
|
-
- "Commits with descriptive messages"
|
|
18
|
-
- "Archived plan in .claude/plans/completed/"
|
|
19
|
-
next_commands: ["/verify-docs-current", "/validate-all"]
|
|
20
|
-
related_agents: ["core-architect", "database-ops", "api-developer", "deployment-ops"]
|
|
21
|
-
examples:
|
|
22
|
-
- command: "/rpi-implement user-authentication"
|
|
23
|
-
description: "Execute the approved authentication plan"
|
|
24
|
-
- command: "/rpi-implement payment-bug-fix"
|
|
25
|
-
description: "Implement the approved bug fix"
|
|
26
|
-
exit_criteria:
|
|
27
|
-
- "All plan steps completed"
|
|
28
|
-
- "All tests passing"
|
|
29
|
-
- "Documentation updated"
|
|
30
|
-
- "Changes committed"
|
|
31
|
-
- "Plan archived to completed/"
|
|
32
|
-
---
|
|
33
|
-
|
|
34
|
-
# RPI Implement Phase
|
|
35
|
-
|
|
36
|
-
**Purpose:** Execute implementation plan atomically
|
|
37
|
-
|
|
38
|
-
**Syntax:** `/rpi-implement [feature-name]`
|
|
39
|
-
|
|
40
|
-
**Prerequisites:** Plan must be approved in `.claude/plans/active/`
|
|
41
|
-
|
|
42
|
-
---
|
|
43
|
-
|
|
44
|
-
## Golden Rule
|
|
45
|
-
|
|
46
|
-
```
|
|
47
|
-
ONE CHANGE → ONE TEST → ONE COMMIT
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
---
|
|
51
|
-
|
|
52
|
-
## Execution Steps
|
|
53
|
-
|
|
54
|
-
### Step 1: Load Plan
|
|
55
|
-
Read `.claude/plans/active/[feature]_plan.md`
|
|
56
|
-
|
|
57
|
-
### Step 2: Verify Preconditions
|
|
58
|
-
- [ ] Plan is approved
|
|
59
|
-
- [ ] Branch is clean
|
|
60
|
-
- [ ] Tests pass before changes
|
|
61
|
-
|
|
62
|
-
### Step 3: Execute Each Step
|
|
63
|
-
For each step in plan:
|
|
64
|
-
1. Make the single, atomic change
|
|
65
|
-
2. Run step-specific test
|
|
66
|
-
3. If pass: commit with descriptive message
|
|
67
|
-
4. If fail: stop, investigate, do not proceed
|
|
68
|
-
|
|
69
|
-
### Step 4: Context Reset (Every 3 Steps)
|
|
70
|
-
1. Update progress in plan
|
|
71
|
-
2. Re-read plan document
|
|
72
|
-
3. Verify scope alignment
|
|
73
|
-
4. Compact if >35% context usage
|
|
74
|
-
|
|
75
|
-
### Step 5: Run Full Test Suite
|
|
76
|
-
After all steps complete
|
|
77
|
-
|
|
78
|
-
### Step 6: Update Documentation (MANDATORY)
|
|
79
|
-
1. Check CODE_TO_WORKFLOW_MAP.md
|
|
80
|
-
2. Update affected workflow files
|
|
81
|
-
3. Update line numbers
|
|
82
|
-
4. Run /verify-docs-current
|
|
83
|
-
|
|
84
|
-
### Step 7: Final Commit
|
|
85
|
-
Documentation updates
|
|
86
|
-
|
|
87
|
-
### Step 8: Archive Plan
|
|
88
|
-
Move to `.claude/plans/completed/`
|
|
89
|
-
|
|
90
|
-
---
|
|
91
|
-
|
|
92
|
-
## Error Recovery
|
|
93
|
-
|
|
94
|
-
| Error Type | Action |
|
|
95
|
-
|------------|--------|
|
|
96
|
-
| Syntax Error | Fix immediately |
|
|
97
|
-
| Test Failure | Stop, investigate |
|
|
98
|
-
| 3+ Failures | Compact, start new session |
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
## Context Budget
|
|
103
|
-
|
|
104
|
-
- Plan: 15k tokens
|
|
105
|
-
- Active code: 30k tokens
|
|
106
|
-
- Test results: 15k tokens
|
|
107
|
-
- Total: 60k tokens (30%)
|
|
108
|
-
|
|
109
|
-
---
|
|
110
|
-
|
|
111
|
-
## Output
|
|
112
|
-
|
|
113
|
-
- Completed feature/fix
|
|
114
|
-
- Updated documentation
|
|
115
|
-
- Plan archived to completed/
|
|
1
|
+
---
|
|
2
|
+
name: rpi-implement
|
|
3
|
+
version: "1.0.0"
|
|
4
|
+
description: "RPI Implement Phase: Execute plan with atomic changes and continuous testing"
|
|
5
|
+
category: "rpi-orchestration"
|
|
6
|
+
rpi_phase: "implement"
|
|
7
|
+
context_budget_estimate: "60K tokens"
|
|
8
|
+
typical_context_usage: "30%"
|
|
9
|
+
prerequisites:
|
|
10
|
+
- "Plan document exists in .claude/plans/active/"
|
|
11
|
+
- "Plan has been approved by human"
|
|
12
|
+
- "Git branch is clean"
|
|
13
|
+
- "All tests currently passing"
|
|
14
|
+
outputs:
|
|
15
|
+
- "Implemented feature/fix"
|
|
16
|
+
- "Updated documentation with new line numbers"
|
|
17
|
+
- "Commits with descriptive messages"
|
|
18
|
+
- "Archived plan in .claude/plans/completed/"
|
|
19
|
+
next_commands: ["/verify-docs-current", "/validate-all"]
|
|
20
|
+
related_agents: ["core-architect", "database-ops", "api-developer", "deployment-ops"]
|
|
21
|
+
examples:
|
|
22
|
+
- command: "/rpi-implement user-authentication"
|
|
23
|
+
description: "Execute the approved authentication plan"
|
|
24
|
+
- command: "/rpi-implement payment-bug-fix"
|
|
25
|
+
description: "Implement the approved bug fix"
|
|
26
|
+
exit_criteria:
|
|
27
|
+
- "All plan steps completed"
|
|
28
|
+
- "All tests passing"
|
|
29
|
+
- "Documentation updated"
|
|
30
|
+
- "Changes committed"
|
|
31
|
+
- "Plan archived to completed/"
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
# RPI Implement Phase
|
|
35
|
+
|
|
36
|
+
**Purpose:** Execute implementation plan atomically
|
|
37
|
+
|
|
38
|
+
**Syntax:** `/rpi-implement [feature-name]`
|
|
39
|
+
|
|
40
|
+
**Prerequisites:** Plan must be approved in `.claude/plans/active/`
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Golden Rule
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
ONE CHANGE → ONE TEST → ONE COMMIT
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## Execution Steps
|
|
53
|
+
|
|
54
|
+
### Step 1: Load Plan
|
|
55
|
+
Read `.claude/plans/active/[feature]_plan.md`
|
|
56
|
+
|
|
57
|
+
### Step 2: Verify Preconditions
|
|
58
|
+
- [ ] Plan is approved
|
|
59
|
+
- [ ] Branch is clean
|
|
60
|
+
- [ ] Tests pass before changes
|
|
61
|
+
|
|
62
|
+
### Step 3: Execute Each Step
|
|
63
|
+
For each step in plan:
|
|
64
|
+
1. Make the single, atomic change
|
|
65
|
+
2. Run step-specific test
|
|
66
|
+
3. If pass: commit with descriptive message
|
|
67
|
+
4. If fail: stop, investigate, do not proceed
|
|
68
|
+
|
|
69
|
+
### Step 4: Context Reset (Every 3 Steps)
|
|
70
|
+
1. Update progress in plan
|
|
71
|
+
2. Re-read plan document
|
|
72
|
+
3. Verify scope alignment
|
|
73
|
+
4. Compact if >35% context usage
|
|
74
|
+
|
|
75
|
+
### Step 5: Run Full Test Suite
|
|
76
|
+
After all steps complete
|
|
77
|
+
|
|
78
|
+
### Step 6: Update Documentation (MANDATORY)
|
|
79
|
+
1. Check CODE_TO_WORKFLOW_MAP.md
|
|
80
|
+
2. Update affected workflow files
|
|
81
|
+
3. Update line numbers
|
|
82
|
+
4. Run /verify-docs-current
|
|
83
|
+
|
|
84
|
+
### Step 7: Final Commit
|
|
85
|
+
Documentation updates
|
|
86
|
+
|
|
87
|
+
### Step 8: Archive Plan
|
|
88
|
+
Move to `.claude/plans/completed/`
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## Error Recovery
|
|
93
|
+
|
|
94
|
+
| Error Type | Action |
|
|
95
|
+
|------------|--------|
|
|
96
|
+
| Syntax Error | Fix immediately |
|
|
97
|
+
| Test Failure | Stop, investigate |
|
|
98
|
+
| 3+ Failures | Compact, start new session |
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## Context Budget
|
|
103
|
+
|
|
104
|
+
- Plan: 15k tokens
|
|
105
|
+
- Active code: 30k tokens
|
|
106
|
+
- Test results: 15k tokens
|
|
107
|
+
- Total: 60k tokens (30%)
|
|
108
|
+
|
|
109
|
+
---
|
|
110
|
+
|
|
111
|
+
## Output
|
|
112
|
+
|
|
113
|
+
- Completed feature/fix
|
|
114
|
+
- Updated documentation
|
|
115
|
+
- Plan archived to completed/
|
|
@@ -1,93 +1,93 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: rpi-plan
|
|
3
|
-
version: "1.0.0"
|
|
4
|
-
description: "RPI Plan Phase: Create implementation blueprint with file:line precision"
|
|
5
|
-
category: "rpi-orchestration"
|
|
6
|
-
rpi_phase: "plan"
|
|
7
|
-
context_budget_estimate: "35K tokens"
|
|
8
|
-
typical_context_usage: "17%"
|
|
9
|
-
prerequisites:
|
|
10
|
-
- "Research document exists in .claude/research/active/"
|
|
11
|
-
- "/rpi-research phase completed"
|
|
12
|
-
outputs:
|
|
13
|
-
- "Plan document in .claude/plans/active/[name]_plan.md"
|
|
14
|
-
- "Modification table with file:line references"
|
|
15
|
-
- "Step-by-step implementation guide"
|
|
16
|
-
- "Test strategy"
|
|
17
|
-
- "Rollback plan"
|
|
18
|
-
next_commands: ["/rpi-implement"]
|
|
19
|
-
related_agents: ["core-architect", "database-ops", "api-developer"]
|
|
20
|
-
examples:
|
|
21
|
-
- command: "/rpi-plan user-authentication"
|
|
22
|
-
description: "Create implementation plan for auth feature"
|
|
23
|
-
- command: "/rpi-plan payment-bug-fix"
|
|
24
|
-
description: "Plan the fix for payment issue"
|
|
25
|
-
exit_criteria:
|
|
26
|
-
- "Plan document created in .claude/plans/active/"
|
|
27
|
-
- "All file modifications listed with line numbers"
|
|
28
|
-
- "Step-by-step implementation defined"
|
|
29
|
-
- "Test strategy documented"
|
|
30
|
-
- "Human approval obtained"
|
|
31
|
-
---
|
|
32
|
-
|
|
33
|
-
# RPI Plan Phase
|
|
34
|
-
|
|
35
|
-
**Purpose:** Create detailed implementation blueprint
|
|
36
|
-
|
|
37
|
-
**Syntax:** `/rpi-plan [feature-name]`
|
|
38
|
-
|
|
39
|
-
**Prerequisites:** Research document must exist in `.claude/research/active/`
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
## Execution Steps
|
|
44
|
-
|
|
45
|
-
### Step 1: Load Research Document
|
|
46
|
-
Read `.claude/research/active/[feature]_research.md`
|
|
47
|
-
|
|
48
|
-
### Step 2: Define Scope
|
|
49
|
-
- In scope (explicit list)
|
|
50
|
-
- Out of scope (what we're NOT touching)
|
|
51
|
-
|
|
52
|
-
### Step 3: List File Modifications
|
|
53
|
-
| File | Lines | Change | Risk |
|
|
54
|
-
|------|-------|--------|------|
|
|
55
|
-
Each modification with exact line numbers
|
|
56
|
-
|
|
57
|
-
### Step 4: Create Step-by-Step Plan
|
|
58
|
-
For each step:
|
|
59
|
-
- Current code
|
|
60
|
-
- Proposed change
|
|
61
|
-
- Test to run after
|
|
62
|
-
|
|
63
|
-
### Step 5: Define Test Strategy
|
|
64
|
-
- Unit tests required
|
|
65
|
-
- Integration tests required
|
|
66
|
-
- E2E tests if applicable
|
|
67
|
-
|
|
68
|
-
### Step 6: Document Rollback Plan
|
|
69
|
-
- How to revert
|
|
70
|
-
- Safe commit to return to
|
|
71
|
-
|
|
72
|
-
### Step 7: Request Human Approval
|
|
73
|
-
Plan requires human review before implementation
|
|
74
|
-
|
|
75
|
-
---
|
|
76
|
-
|
|
77
|
-
## Output
|
|
78
|
-
|
|
79
|
-
Plan document in `.claude/plans/active/[feature]_plan.md`
|
|
80
|
-
|
|
81
|
-
---
|
|
82
|
-
|
|
83
|
-
## Context Budget
|
|
84
|
-
|
|
85
|
-
- Research doc: 20k tokens
|
|
86
|
-
- Plan creation: 15k tokens
|
|
87
|
-
- Total: 35k tokens (17%)
|
|
88
|
-
|
|
89
|
-
---
|
|
90
|
-
|
|
91
|
-
## Next Step
|
|
92
|
-
|
|
93
|
-
After human approval: `/rpi-implement [feature-name]`
|
|
1
|
+
---
|
|
2
|
+
name: rpi-plan
|
|
3
|
+
version: "1.0.0"
|
|
4
|
+
description: "RPI Plan Phase: Create implementation blueprint with file:line precision"
|
|
5
|
+
category: "rpi-orchestration"
|
|
6
|
+
rpi_phase: "plan"
|
|
7
|
+
context_budget_estimate: "35K tokens"
|
|
8
|
+
typical_context_usage: "17%"
|
|
9
|
+
prerequisites:
|
|
10
|
+
- "Research document exists in .claude/research/active/"
|
|
11
|
+
- "/rpi-research phase completed"
|
|
12
|
+
outputs:
|
|
13
|
+
- "Plan document in .claude/plans/active/[name]_plan.md"
|
|
14
|
+
- "Modification table with file:line references"
|
|
15
|
+
- "Step-by-step implementation guide"
|
|
16
|
+
- "Test strategy"
|
|
17
|
+
- "Rollback plan"
|
|
18
|
+
next_commands: ["/rpi-implement"]
|
|
19
|
+
related_agents: ["core-architect", "database-ops", "api-developer"]
|
|
20
|
+
examples:
|
|
21
|
+
- command: "/rpi-plan user-authentication"
|
|
22
|
+
description: "Create implementation plan for auth feature"
|
|
23
|
+
- command: "/rpi-plan payment-bug-fix"
|
|
24
|
+
description: "Plan the fix for payment issue"
|
|
25
|
+
exit_criteria:
|
|
26
|
+
- "Plan document created in .claude/plans/active/"
|
|
27
|
+
- "All file modifications listed with line numbers"
|
|
28
|
+
- "Step-by-step implementation defined"
|
|
29
|
+
- "Test strategy documented"
|
|
30
|
+
- "Human approval obtained"
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
# RPI Plan Phase
|
|
34
|
+
|
|
35
|
+
**Purpose:** Create detailed implementation blueprint
|
|
36
|
+
|
|
37
|
+
**Syntax:** `/rpi-plan [feature-name]`
|
|
38
|
+
|
|
39
|
+
**Prerequisites:** Research document must exist in `.claude/research/active/`
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Execution Steps
|
|
44
|
+
|
|
45
|
+
### Step 1: Load Research Document
|
|
46
|
+
Read `.claude/research/active/[feature]_research.md`
|
|
47
|
+
|
|
48
|
+
### Step 2: Define Scope
|
|
49
|
+
- In scope (explicit list)
|
|
50
|
+
- Out of scope (what we're NOT touching)
|
|
51
|
+
|
|
52
|
+
### Step 3: List File Modifications
|
|
53
|
+
| File | Lines | Change | Risk |
|
|
54
|
+
|------|-------|--------|------|
|
|
55
|
+
Each modification with exact line numbers
|
|
56
|
+
|
|
57
|
+
### Step 4: Create Step-by-Step Plan
|
|
58
|
+
For each step:
|
|
59
|
+
- Current code
|
|
60
|
+
- Proposed change
|
|
61
|
+
- Test to run after
|
|
62
|
+
|
|
63
|
+
### Step 5: Define Test Strategy
|
|
64
|
+
- Unit tests required
|
|
65
|
+
- Integration tests required
|
|
66
|
+
- E2E tests if applicable
|
|
67
|
+
|
|
68
|
+
### Step 6: Document Rollback Plan
|
|
69
|
+
- How to revert
|
|
70
|
+
- Safe commit to return to
|
|
71
|
+
|
|
72
|
+
### Step 7: Request Human Approval
|
|
73
|
+
Plan requires human review before implementation
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## Output
|
|
78
|
+
|
|
79
|
+
Plan document in `.claude/plans/active/[feature]_plan.md`
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## Context Budget
|
|
84
|
+
|
|
85
|
+
- Research doc: 20k tokens
|
|
86
|
+
- Plan creation: 15k tokens
|
|
87
|
+
- Total: 35k tokens (17%)
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Next Step
|
|
92
|
+
|
|
93
|
+
After human approval: `/rpi-implement [feature-name]`
|
|
@@ -1,88 +1,88 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: rpi-research
|
|
3
|
-
version: "1.0.0"
|
|
4
|
-
description: "RPI Research Phase: Systematic codebase exploration for feature/fix analysis"
|
|
5
|
-
category: "rpi-orchestration"
|
|
6
|
-
rpi_phase: "research"
|
|
7
|
-
context_budget_estimate: "50K tokens"
|
|
8
|
-
typical_context_usage: "25%"
|
|
9
|
-
prerequisites: []
|
|
10
|
-
outputs:
|
|
11
|
-
- "Research document in .claude/research/active/[name]_research.md"
|
|
12
|
-
- "File inventory with line references"
|
|
13
|
-
- "Call chain diagrams"
|
|
14
|
-
- "Dependency map"
|
|
15
|
-
next_commands: ["/rpi-plan"]
|
|
16
|
-
related_agents: ["context-engineer", "core-architect"]
|
|
17
|
-
examples:
|
|
18
|
-
- command: "/rpi-research user-authentication"
|
|
19
|
-
description: "Research authentication flow for new feature"
|
|
20
|
-
- command: "/rpi-research payment-bug-fix"
|
|
21
|
-
description: "Investigate payment processing issue"
|
|
22
|
-
exit_criteria:
|
|
23
|
-
- "Research document created in .claude/research/active/"
|
|
24
|
-
- "All relevant files identified (3-20 files)"
|
|
25
|
-
- "Call chains traced with line numbers"
|
|
26
|
-
- "Dependencies mapped"
|
|
27
|
-
- "150-word summary generated"
|
|
28
|
-
---
|
|
29
|
-
|
|
30
|
-
# RPI Research Phase
|
|
31
|
-
|
|
32
|
-
**Purpose:** Systematic, zero-code-modification exploration
|
|
33
|
-
|
|
34
|
-
**Syntax:** `/rpi-research [feature-name]`
|
|
35
|
-
|
|
36
|
-
**Example:**
|
|
37
|
-
```bash
|
|
38
|
-
/rpi-research user-authentication
|
|
39
|
-
/rpi-research payment-bug-fix
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
---
|
|
43
|
-
|
|
44
|
-
## Execution Steps
|
|
45
|
-
|
|
46
|
-
### Step 1: Initialize Research Document
|
|
47
|
-
Create `.claude/research/active/[feature]_research.md` from RESEARCH_TEMPLATE.md
|
|
48
|
-
|
|
49
|
-
### Step 2: Entry Point Discovery (3 parallel agents)
|
|
50
|
-
- Agent 1: API/Route entry points
|
|
51
|
-
- Agent 2: Business logic locations
|
|
52
|
-
- Agent 3: Database/external integrations
|
|
53
|
-
|
|
54
|
-
### Step 3: Call Chain Tracing
|
|
55
|
-
- Read entry point files
|
|
56
|
-
- Trace 3 levels deep
|
|
57
|
-
- Record with file:line references
|
|
58
|
-
|
|
59
|
-
### Step 4: Dependency Mapping
|
|
60
|
-
- Internal service dependencies
|
|
61
|
-
- External API dependencies
|
|
62
|
-
|
|
63
|
-
### Step 5: Test Coverage Analysis
|
|
64
|
-
- Find existing tests
|
|
65
|
-
- Identify gaps
|
|
66
|
-
|
|
67
|
-
### Step 6: Generate Summary
|
|
68
|
-
- 150-word summary for Plan phase
|
|
69
|
-
|
|
70
|
-
---
|
|
71
|
-
|
|
72
|
-
## Output
|
|
73
|
-
|
|
74
|
-
Research document in `.claude/research/active/[feature]_research.md`
|
|
75
|
-
|
|
76
|
-
---
|
|
77
|
-
|
|
78
|
-
## Context Budget
|
|
79
|
-
|
|
80
|
-
- Target: 25% of 200k (50k tokens)
|
|
81
|
-
- Compaction: After each major step
|
|
82
|
-
- Final: ~20k tokens (research doc only)
|
|
83
|
-
|
|
84
|
-
---
|
|
85
|
-
|
|
86
|
-
## Next Step
|
|
87
|
-
|
|
88
|
-
After completion: `/rpi-plan [feature-name]`
|
|
1
|
+
---
|
|
2
|
+
name: rpi-research
|
|
3
|
+
version: "1.0.0"
|
|
4
|
+
description: "RPI Research Phase: Systematic codebase exploration for feature/fix analysis"
|
|
5
|
+
category: "rpi-orchestration"
|
|
6
|
+
rpi_phase: "research"
|
|
7
|
+
context_budget_estimate: "50K tokens"
|
|
8
|
+
typical_context_usage: "25%"
|
|
9
|
+
prerequisites: []
|
|
10
|
+
outputs:
|
|
11
|
+
- "Research document in .claude/research/active/[name]_research.md"
|
|
12
|
+
- "File inventory with line references"
|
|
13
|
+
- "Call chain diagrams"
|
|
14
|
+
- "Dependency map"
|
|
15
|
+
next_commands: ["/rpi-plan"]
|
|
16
|
+
related_agents: ["context-engineer", "core-architect"]
|
|
17
|
+
examples:
|
|
18
|
+
- command: "/rpi-research user-authentication"
|
|
19
|
+
description: "Research authentication flow for new feature"
|
|
20
|
+
- command: "/rpi-research payment-bug-fix"
|
|
21
|
+
description: "Investigate payment processing issue"
|
|
22
|
+
exit_criteria:
|
|
23
|
+
- "Research document created in .claude/research/active/"
|
|
24
|
+
- "All relevant files identified (3-20 files)"
|
|
25
|
+
- "Call chains traced with line numbers"
|
|
26
|
+
- "Dependencies mapped"
|
|
27
|
+
- "150-word summary generated"
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
# RPI Research Phase
|
|
31
|
+
|
|
32
|
+
**Purpose:** Systematic, zero-code-modification exploration
|
|
33
|
+
|
|
34
|
+
**Syntax:** `/rpi-research [feature-name]`
|
|
35
|
+
|
|
36
|
+
**Example:**
|
|
37
|
+
```bash
|
|
38
|
+
/rpi-research user-authentication
|
|
39
|
+
/rpi-research payment-bug-fix
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## Execution Steps
|
|
45
|
+
|
|
46
|
+
### Step 1: Initialize Research Document
|
|
47
|
+
Create `.claude/research/active/[feature]_research.md` from RESEARCH_TEMPLATE.md
|
|
48
|
+
|
|
49
|
+
### Step 2: Entry Point Discovery (3 parallel agents)
|
|
50
|
+
- Agent 1: API/Route entry points
|
|
51
|
+
- Agent 2: Business logic locations
|
|
52
|
+
- Agent 3: Database/external integrations
|
|
53
|
+
|
|
54
|
+
### Step 3: Call Chain Tracing
|
|
55
|
+
- Read entry point files
|
|
56
|
+
- Trace 3 levels deep
|
|
57
|
+
- Record with file:line references
|
|
58
|
+
|
|
59
|
+
### Step 4: Dependency Mapping
|
|
60
|
+
- Internal service dependencies
|
|
61
|
+
- External API dependencies
|
|
62
|
+
|
|
63
|
+
### Step 5: Test Coverage Analysis
|
|
64
|
+
- Find existing tests
|
|
65
|
+
- Identify gaps
|
|
66
|
+
|
|
67
|
+
### Step 6: Generate Summary
|
|
68
|
+
- 150-word summary for Plan phase
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Output
|
|
73
|
+
|
|
74
|
+
Research document in `.claude/research/active/[feature]_research.md`
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## Context Budget
|
|
79
|
+
|
|
80
|
+
- Target: 25% of 200k (50k tokens)
|
|
81
|
+
- Compaction: After each major step
|
|
82
|
+
- Final: ~20k tokens (research doc only)
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Next Step
|
|
87
|
+
|
|
88
|
+
After completion: `/rpi-plan [feature-name]`
|