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.
Files changed (117) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +169 -146
  3. package/bin/create-claude-context.js +75 -61
  4. package/lib/ai-orchestrator.js +423 -0
  5. package/lib/call-tracer.js +444 -0
  6. package/lib/detector.js +456 -373
  7. package/lib/environment-detector.js +239 -0
  8. package/lib/index.js +271 -170
  9. package/lib/installer.js +371 -362
  10. package/lib/placeholder.js +269 -208
  11. package/lib/prompts.js +287 -287
  12. package/lib/spinner.js +60 -60
  13. package/lib/static-analyzer.js +729 -0
  14. package/lib/template-populator.js +835 -0
  15. package/lib/validate.js +147 -147
  16. package/package.json +59 -59
  17. package/templates/CLAUDE.md.template +235 -235
  18. package/templates/base/README.md +257 -257
  19. package/templates/base/RPI_WORKFLOW_PLAN.md +320 -320
  20. package/templates/base/agents/api-developer.md +76 -76
  21. package/templates/base/agents/context-engineer.md +525 -525
  22. package/templates/base/agents/core-architect.md +76 -76
  23. package/templates/base/agents/database-ops.md +76 -76
  24. package/templates/base/agents/deployment-ops.md +76 -76
  25. package/templates/base/agents/integration-hub.md +76 -76
  26. package/templates/base/analytics/README.md +114 -114
  27. package/templates/base/automation/config.json +58 -0
  28. package/templates/base/automation/generators/code-mapper.js +308 -0
  29. package/templates/base/automation/generators/index-builder.js +321 -0
  30. package/templates/base/automation/hooks/post-commit.sh +83 -0
  31. package/templates/base/automation/hooks/pre-commit.sh +103 -0
  32. package/templates/base/ci-templates/README.md +108 -108
  33. package/templates/base/ci-templates/github-actions/context-check.yml +144 -144
  34. package/templates/base/ci-templates/github-actions/validate-docs.yml +105 -105
  35. package/templates/base/commands/analytics.md +238 -238
  36. package/templates/base/commands/auto-sync.md +172 -0
  37. package/templates/base/commands/collab.md +194 -194
  38. package/templates/base/commands/help.md +450 -450
  39. package/templates/base/commands/rpi-implement.md +115 -115
  40. package/templates/base/commands/rpi-plan.md +93 -93
  41. package/templates/base/commands/rpi-research.md +88 -88
  42. package/templates/base/commands/session-resume.md +144 -0
  43. package/templates/base/commands/session-save.md +112 -0
  44. package/templates/base/commands/validate-all.md +77 -77
  45. package/templates/base/commands/verify-docs-current.md +86 -86
  46. package/templates/base/config/base.json +57 -57
  47. package/templates/base/config/environments/development.json +13 -13
  48. package/templates/base/config/environments/production.json +17 -17
  49. package/templates/base/config/environments/staging.json +13 -13
  50. package/templates/base/config/local.json.example +21 -21
  51. package/templates/base/context/.meta/generated-at.json +18 -0
  52. package/templates/base/context/ARCHITECTURE_SNAPSHOT.md +156 -156
  53. package/templates/base/context/CODE_TO_WORKFLOW_MAP.md +94 -94
  54. package/templates/base/context/FILE_OWNERSHIP.md +57 -0
  55. package/templates/base/context/INTEGRATION_POINTS.md +92 -0
  56. package/templates/base/context/KNOWN_GOTCHAS.md +195 -195
  57. package/templates/base/context/TESTING_MAP.md +95 -0
  58. package/templates/base/context/WORKFLOW_INDEX.md +129 -129
  59. package/templates/base/context/workflows/WORKFLOW_TEMPLATE.md +294 -294
  60. package/templates/base/indexes/agents/CAPABILITY_MATRIX.md +255 -255
  61. package/templates/base/indexes/agents/CATEGORY_INDEX.md +44 -44
  62. package/templates/base/indexes/code/CATEGORY_INDEX.md +38 -38
  63. package/templates/base/indexes/routing/CATEGORY_INDEX.md +39 -39
  64. package/templates/base/indexes/search/CATEGORY_INDEX.md +39 -39
  65. package/templates/base/indexes/workflows/CATEGORY_INDEX.md +38 -38
  66. package/templates/base/knowledge/README.md +98 -98
  67. package/templates/base/knowledge/sessions/README.md +88 -88
  68. package/templates/base/knowledge/sessions/TEMPLATE.md +150 -150
  69. package/templates/base/knowledge/shared/decisions/0001-adopt-context-engineering.md +144 -144
  70. package/templates/base/knowledge/shared/decisions/README.md +49 -49
  71. package/templates/base/knowledge/shared/decisions/TEMPLATE.md +123 -123
  72. package/templates/base/knowledge/shared/patterns/README.md +62 -62
  73. package/templates/base/knowledge/shared/patterns/TEMPLATE.md +120 -120
  74. package/templates/base/plans/PLAN_TEMPLATE.md +250 -250
  75. package/templates/base/research/RESEARCH_TEMPLATE.md +153 -153
  76. package/templates/base/schemas/agent.schema.json +141 -141
  77. package/templates/base/schemas/anchors.schema.json +54 -0
  78. package/templates/base/schemas/automation.schema.json +93 -0
  79. package/templates/base/schemas/command.schema.json +134 -134
  80. package/templates/base/schemas/hashes.schema.json +40 -0
  81. package/templates/base/schemas/manifest.schema.json +117 -117
  82. package/templates/base/schemas/plan.schema.json +136 -136
  83. package/templates/base/schemas/research.schema.json +115 -115
  84. package/templates/base/schemas/roles.schema.json +34 -0
  85. package/templates/base/schemas/session.schema.json +77 -0
  86. package/templates/base/schemas/settings.schema.json +244 -244
  87. package/templates/base/schemas/staleness.schema.json +53 -0
  88. package/templates/base/schemas/team-config.schema.json +42 -0
  89. package/templates/base/schemas/workflow.schema.json +126 -126
  90. package/templates/base/session/checkpoints/.gitkeep +2 -0
  91. package/templates/base/session/current/state.json +20 -0
  92. package/templates/base/session/history/.gitkeep +2 -0
  93. package/templates/base/settings.json +3 -57
  94. package/templates/base/standards/COMPATIBILITY.md +219 -219
  95. package/templates/base/standards/EXTENSION_GUIDELINES.md +280 -280
  96. package/templates/base/standards/QUALITY_CHECKLIST.md +211 -211
  97. package/templates/base/standards/README.md +66 -66
  98. package/templates/base/sync/anchors.json +6 -0
  99. package/templates/base/sync/hashes.json +6 -0
  100. package/templates/base/sync/staleness.json +10 -0
  101. package/templates/base/team/README.md +168 -168
  102. package/templates/base/team/config.json +79 -79
  103. package/templates/base/team/roles.json +145 -145
  104. package/templates/base/tools/bin/claude-context.js +151 -151
  105. package/templates/base/tools/lib/anchor-resolver.js +276 -0
  106. package/templates/base/tools/lib/config-loader.js +363 -363
  107. package/templates/base/tools/lib/detector.js +350 -350
  108. package/templates/base/tools/lib/diagnose.js +206 -206
  109. package/templates/base/tools/lib/drift-detector.js +373 -0
  110. package/templates/base/tools/lib/errors.js +199 -199
  111. package/templates/base/tools/lib/index.js +36 -24
  112. package/templates/base/tools/lib/init.js +192 -192
  113. package/templates/base/tools/lib/logger.js +230 -230
  114. package/templates/base/tools/lib/placeholder.js +201 -201
  115. package/templates/base/tools/lib/session-manager.js +354 -0
  116. package/templates/base/tools/lib/validate.js +521 -521
  117. 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]`