create-claude-context 1.0.0 → 1.2.0

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