planflow-ai 1.4.1 → 1.4.3
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/.claude/commands/brainstorm.md +6 -14
- package/.claude/commands/create-contract.md +6 -38
- package/.claude/commands/create-plan.md +7 -38
- package/.claude/commands/discovery-plan.md +7 -49
- package/.claude/commands/execute-plan.md +11 -63
- package/.claude/commands/heartbeat.md +12 -14
- package/.claude/commands/learn.md +20 -80
- package/.claude/commands/note.md +6 -23
- package/.claude/commands/review-code.md +8 -51
- package/.claude/commands/review-pr.md +10 -57
- package/.claude/commands/setup.md +8 -56
- package/.claude/commands/write-tests.md +7 -41
- package/.claude/resources/core/phase-isolation.md +46 -1
- package/.claude/resources/core/shared-context.md +110 -0
- package/.claude/resources/core/wave-execution.md +79 -1
- package/.claude/resources/skills/execute-plan-skill.md +74 -13
- package/README.md +154 -96
- package/dist/cli/commands/brain.d.ts +20 -0
- package/dist/cli/commands/brain.d.ts.map +1 -0
- package/dist/cli/commands/brain.js +127 -0
- package/dist/cli/commands/brain.js.map +1 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +9 -0
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/state-query.d.ts +13 -0
- package/dist/cli/commands/state-query.d.ts.map +1 -0
- package/dist/cli/commands/state-query.js +32 -0
- package/dist/cli/commands/state-query.js.map +1 -0
- package/dist/cli/daemon/shared-context.d.ts +38 -0
- package/dist/cli/daemon/shared-context.d.ts.map +1 -0
- package/dist/cli/daemon/shared-context.js +129 -0
- package/dist/cli/daemon/shared-context.js.map +1 -0
- package/dist/cli/handlers/claude.d.ts.map +1 -1
- package/dist/cli/handlers/claude.js +18 -0
- package/dist/cli/handlers/claude.js.map +1 -1
- package/dist/cli/handlers/shared.js +1 -1
- package/dist/cli/handlers/shared.js.map +1 -1
- package/dist/cli/index.js +21 -0
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/state/brain-query.d.ts +48 -0
- package/dist/cli/state/brain-query.d.ts.map +1 -0
- package/dist/cli/state/brain-query.js +113 -0
- package/dist/cli/state/brain-query.js.map +1 -0
- package/dist/cli/state/types.d.ts +31 -0
- package/dist/cli/state/types.d.ts.map +1 -1
- package/package.json +4 -1
- package/.claude/resources/core/_index.md +0 -347
- package/.claude/resources/languages/_index.md +0 -76
- package/.claude/resources/patterns/_index.md +0 -200
- package/.claude/resources/skills/_index.md +0 -287
- package/.claude/resources/tools/_index.md +0 -110
- package/.claude/resources/tools/reference-expansion-tool.md +0 -326
|
@@ -1,287 +0,0 @@
|
|
|
1
|
-
|
|
2
|
-
# Skills Index
|
|
3
|
-
|
|
4
|
-
## Overview
|
|
5
|
-
|
|
6
|
-
Skills implement the workflow logic for commands. Each skill orchestrates a specific process like discovery, planning, execution, or code review.
|
|
7
|
-
|
|
8
|
-
**Total Files**: 12 files, ~3,500 lines
|
|
9
|
-
**Reference Codes**: SKL-BR-1 through SKL-TEST-5
|
|
10
|
-
|
|
11
|
-
> **Note**: All skills (except brain and flow) include a Resource Capture section. During execution, the LLM watches for valuable reference materials and asks the user before saving to `flow/resources/`. See `.claude/resources/core/resource-capture.md` for full rules.
|
|
12
|
-
>
|
|
13
|
-
> **Note**: The execute-plan, discovery, and review-code skills also include Pattern Capture. During execution, the LLM silently buffers coding patterns and anti-patterns, then presents them for user approval at the end. Approved patterns are written to `.claude/rules/core/allowed-patterns.md` or `forbidden-patterns.md`. See `.claude/resources/core/pattern-capture.md` for full rules.
|
|
14
|
-
>
|
|
15
|
-
> **Note**: The execute-plan skill supports **Model Routing** — automatic model selection per phase based on complexity scores (0-3 → haiku, 4-5 → sonnet, 6-10 → opus). Controlled by `model_routing` in `flow/.flowconfig`. See `.claude/resources/core/model-routing.md` for full rules.
|
|
16
|
-
>
|
|
17
|
-
> **Note**: The execute-plan skill supports **Wave-Based Parallel Execution** — dependency-aware grouping of independent phases into parallel waves. When `wave_execution: true` in `.flowconfig` (default), phases with explicit `Dependencies` metadata are analyzed, grouped into waves via topological sort, and executed in parallel within each wave. See `.claude/resources/core/wave-execution.md` for full rules.
|
|
18
|
-
>
|
|
19
|
-
> **Note**: The discovery skill also includes **Design Awareness**. During discovery, the LLM asks whether the feature involves UI work and captures structured design tokens (colors, typography, spacing) into a `## Design Context` section. During execution, these tokens are auto-injected into UI phase prompts. See `.claude/resources/core/design-awareness.md` for full rules.
|
|
20
|
-
>
|
|
21
|
-
> **Note**: The review-code and review-pr skills include a **Verification Pass**. After initial analysis, each finding is re-examined against surrounding code context and classified as Confirmed, Likely, or Dismissed. False positives are filtered before output. See `.claude/resources/core/review-verification.md` for full rules.
|
|
22
|
-
>
|
|
23
|
-
> **Note**: The review-code and review-pr skills include **Multi-Agent Parallel Review** for Deep mode (500+ lines). Four specialized subagents (security, logic, performance, patterns) run in parallel, and the coordinator deduplicates, verifies, and ranks the merged results. See `.claude/resources/core/review-multi-agent.md` for full rules.
|
|
24
|
-
>
|
|
25
|
-
> **Note**: The review-code and review-pr skills include **Severity Re-Ranking**. After verification, findings are re-ranked by severity → confidence → fix complexity, related findings across files are grouped, and an executive summary is added when ≥ 5 findings. See `.claude/resources/core/review-severity-ranking.md` for full rules.
|
|
26
|
-
>
|
|
27
|
-
> **Note**: The review-code and review-pr skills include **Adaptive Depth**. Review depth scales automatically based on changeset size: < 50 lines → Lightweight (quick-scan), 50–500 → Standard (no change), 500+ → Deep (multi-pass with executive summary). See `.claude/resources/core/review-adaptive-depth.md` for full rules.
|
|
28
|
-
>
|
|
29
|
-
> **Note**: All long-running skills (execute-plan, review-code, discovery) support **Context Compaction**. When compacting mid-skill, load `.claude/resources/core/compaction-guide.md` for preserve/discard rules and the compact summary template. See `COR-CG-1` through `COR-CG-4`.
|
|
30
|
-
>
|
|
31
|
-
> **Note**: The discovery skill uses **Discovery Sub-Agents** for parallel codebase exploration. Three haiku sub-agents (similar features, API/data patterns, schema/types) run in parallel after reading referenced docs, returning condensed JSON findings merged into a Codebase Analysis section. See `.claude/resources/core/discovery-sub-agents.md` for full rules.
|
|
32
|
-
|
|
33
|
-
---
|
|
34
|
-
|
|
35
|
-
## Reference Codes
|
|
36
|
-
|
|
37
|
-
### Brainstorm Skill (`brainstorm-skill.md`)
|
|
38
|
-
|
|
39
|
-
| Code | Description | Source | Lines |
|
|
40
|
-
|------|-------------|--------|-------|
|
|
41
|
-
| SKL-BS-1 | Purpose, restrictions, and inputs | brainstorm-skill.md | 8-60 |
|
|
42
|
-
| SKL-BS-2 | Conversational loop, question types, and silent tracking | brainstorm-skill.md | 62-150 |
|
|
43
|
-
| SKL-BS-3 | End detection, summary, output generation, and tasklist offer | brainstorm-skill.md | 152-220 |
|
|
44
|
-
|
|
45
|
-
### Brain Skill (`brain-skill.md`)
|
|
46
|
-
|
|
47
|
-
| Code | Description | Source | Lines |
|
|
48
|
-
|------|-------------|--------|-------|
|
|
49
|
-
| SKL-BR-1 | Purpose and restrictions (brain-only actions) | brain-skill.md | 8-45 |
|
|
50
|
-
| SKL-BR-2 | Workflow (free-text mode and guided mode) | brain-skill.md | 55-130 |
|
|
51
|
-
| SKL-BR-3 | Output format and validation checklist | brain-skill.md | 132-175 |
|
|
52
|
-
|
|
53
|
-
### Create Contract Skill (`create-contract-skill.md`)
|
|
54
|
-
|
|
55
|
-
| Code | Description | Source | Lines |
|
|
56
|
-
|------|-------------|--------|-------|
|
|
57
|
-
| SKL-CON-1 | Purpose and restrictions (allowed/forbidden actions) | create-contract-skill.md | 8-53 |
|
|
58
|
-
| SKL-CON-2 | Workflow (detect source, fetch, ask questions, generate) | create-contract-skill.md | 65-140 |
|
|
59
|
-
| SKL-CON-3 | Contract output template | create-contract-skill.md | 142-215 |
|
|
60
|
-
| SKL-CON-4 | Validation checklist | create-contract-skill.md | 217-240 |
|
|
61
|
-
|
|
62
|
-
### Create Plan Skill (`create-plan-skill.md`)
|
|
63
|
-
|
|
64
|
-
| Code | Description | Source | Lines |
|
|
65
|
-
|------|-------------|--------|-------|
|
|
66
|
-
| SKL-PLN-1 | Purpose and restrictions | create-plan-skill.md | 8-53 |
|
|
67
|
-
| SKL-PLN-2 | Workflow (extract, analyze, structure phases) | create-plan-skill.md | 67-165 |
|
|
68
|
-
| SKL-PLN-3 | Plan output template | create-plan-skill.md | 179-244 |
|
|
69
|
-
| SKL-PLN-4 | Validation checklist | create-plan-skill.md | 246-272 |
|
|
70
|
-
|
|
71
|
-
### Discovery Skill (`discovery-skill.md`)
|
|
72
|
-
|
|
73
|
-
| Code | Description | Source | Lines |
|
|
74
|
-
|------|-------------|--------|-------|
|
|
75
|
-
| SKL-DIS-1 | Purpose and restrictions | discovery-skill.md | 8-57 |
|
|
76
|
-
| SKL-DIS-2 | Workflow steps 1-4 (read docs, questions, tracking, requirements) | discovery-skill.md | 71-173 |
|
|
77
|
-
| SKL-DIS-3 | Workflow steps 5-8 (tech considerations, approach, risks, generate) | discovery-skill.md | 175-256 |
|
|
78
|
-
| SKL-DIS-4 | Validation checklist | discovery-skill.md | 270-296 |
|
|
79
|
-
|
|
80
|
-
### Learn Skill (`learn-skill.md`)
|
|
81
|
-
|
|
82
|
-
| Code | Description | Source | Lines |
|
|
83
|
-
|------|-------------|--------|-------|
|
|
84
|
-
| SKL-LRN-1 | Purpose, restrictions, and extraction criteria | learn-skill.md | 1-55 |
|
|
85
|
-
| SKL-LRN-2 | Workflow, output format, and validation | learn-skill.md | 57-115 |
|
|
86
|
-
| SKL-LRN-3 | Teaching mode restrictions and curriculum generation | learn-skill.md | 140-175 |
|
|
87
|
-
| SKL-LRN-4 | Step confirmation flow and storage rules | learn-skill.md | 177-210 |
|
|
88
|
-
|
|
89
|
-
### Flow Cost Skill (`flow-cost.md`)
|
|
90
|
-
|
|
91
|
-
| Code | Description | Source | Lines |
|
|
92
|
-
|------|-------------|--------|-------|
|
|
93
|
-
| SKL-COST-1 | Usage and filter flags | flow-cost.md | 7-18 |
|
|
94
|
-
| SKL-COST-2 | Implementation steps (read, filter, aggregate, format) | flow-cost.md | 20-85 |
|
|
95
|
-
| SKL-COST-3 | Output format examples (default, detail, session) | flow-cost.md | 87-145 |
|
|
96
|
-
| SKL-COST-4 | JSONL schema and error handling | flow-cost.md | 147-195 |
|
|
97
|
-
|
|
98
|
-
### Execute Plan Skill (`execute-plan-skill.md`)
|
|
99
|
-
|
|
100
|
-
| Code | Description | Source | Lines |
|
|
101
|
-
|------|-------------|--------|-------|
|
|
102
|
-
| SKL-EXEC-1 | Purpose and inputs | execute-plan-skill.md | 4-100 |
|
|
103
|
-
| SKL-EXEC-2 | Critical rules (build only at end, no DB commands) | execute-plan-skill.md | 18-92 |
|
|
104
|
-
| SKL-EXEC-3 | Step 1: Parse the plan | execute-plan-skill.md | 103-112 |
|
|
105
|
-
| SKL-EXEC-4 | Step 2: Analyze complexity + Step 2b: Wave analysis (dependency graph, wave grouping) | execute-plan-skill.md | 113-151 |
|
|
106
|
-
| SKL-EXEC-5 | Step 3: Present execution plan summary (with wave groupings and estimated speedup) | execute-plan-skill.md | 152-180 |
|
|
107
|
-
| SKL-EXEC-6 | Step 4: Execute each wave (approve sequentially, spawn parallel sub-agents per wave) | execute-plan-skill.md | 181-236 |
|
|
108
|
-
| SKL-EXEC-7 | Step 5: Update progress after each phase | execute-plan-skill.md | 237-249 |
|
|
109
|
-
| SKL-EXEC-8 | Step 5b: Phase-boundary context check (compaction) | execute-plan-skill.md | 250-275 |
|
|
110
|
-
| SKL-EXEC-9 | Step 6: Handle tests phase | execute-plan-skill.md | 277-302 |
|
|
111
|
-
| SKL-EXEC-10 | Step 7: Completion — build and test verification | execute-plan-skill.md | 303-364 |
|
|
112
|
-
| SKL-EXEC-11 | Complexity-based behavior (low, medium, high, very high) | execute-plan-skill.md | 365-393 |
|
|
113
|
-
| SKL-EXEC-12 | Error handling (build failures, test failures, cancellation) | execute-plan-skill.md | 395-427 |
|
|
114
|
-
|
|
115
|
-
### Review Code Skill (`review-code-skill.md`)
|
|
116
|
-
|
|
117
|
-
| Code | Description | Source | Lines |
|
|
118
|
-
|------|-------------|--------|-------|
|
|
119
|
-
| SKL-REV-1 | Purpose and restrictions (read-only, allowed actions) | review-code-skill.md | 4-58 |
|
|
120
|
-
| SKL-REV-2 | Step 1: Identify changed files | review-code-skill.md | 70-77 |
|
|
121
|
-
| SKL-REV-3 | Step 1b: Determine review depth (adaptive depth) | review-code-skill.md | 78-97 |
|
|
122
|
-
| SKL-REV-4 | Step 2: Load review patterns | review-code-skill.md | 98-107 |
|
|
123
|
-
| SKL-REV-5 | Step 3: Find similar implementations in codebase | review-code-skill.md | 108-146 |
|
|
124
|
-
| SKL-REV-6 | Step 4: Analyze code changes | review-code-skill.md | 147-158 |
|
|
125
|
-
| SKL-REV-7 | Step 5: Pattern conflicts + 5b verify + 5c re-rank | review-code-skill.md | 159-231 |
|
|
126
|
-
| SKL-REV-8 | Step 6: Generate review document | review-code-skill.md | 232-260 |
|
|
127
|
-
| SKL-REV-9 | Severity levels and conflict resolution | review-code-skill.md | 252-301 |
|
|
128
|
-
| SKL-REV-10 | Finding similar implementations (search strategies) | review-code-skill.md | 303-330 |
|
|
129
|
-
| SKL-REV-11 | Validation checklist | review-code-skill.md | 379-392 |
|
|
130
|
-
|
|
131
|
-
### Review PR Skill (`review-pr-skill.md`)
|
|
132
|
-
|
|
133
|
-
| Code | Description | Source | Lines |
|
|
134
|
-
|------|-------------|--------|-------|
|
|
135
|
-
| SKL-PR-1 | Purpose and restrictions (read-only, GitHub/Azure DevOps) | review-pr-skill.md | 4-120 |
|
|
136
|
-
| SKL-PR-2 | Step 0: Authenticate for PR access | review-pr-skill.md | 132-158 |
|
|
137
|
-
| SKL-PR-3 | Step 1: Fetch PR information + 1b determine review depth | review-pr-skill.md | 159-184 |
|
|
138
|
-
| SKL-PR-4 | Step 2: Load review patterns | review-pr-skill.md | 185-194 |
|
|
139
|
-
| SKL-PR-5 | Step 3: Analyze code changes + 3b verify + 3c re-rank | review-pr-skill.md | 195-240 |
|
|
140
|
-
| SKL-PR-6 | Step 4: Generate or update review document | review-pr-skill.md | 241-320 |
|
|
141
|
-
| SKL-PR-7 | Output format template (findings, severity, recommendations) | review-pr-skill.md | 322-376 |
|
|
142
|
-
| SKL-PR-8 | Fix complexity scoring (scale, modifiers, examples) | review-pr-skill.md | 388-426 |
|
|
143
|
-
| SKL-PR-9 | Link format for GitHub and Azure DevOps | review-pr-skill.md | 428-477 |
|
|
144
|
-
| SKL-PR-10 | Example finding and quick reference commands | review-pr-skill.md | 479-552 |
|
|
145
|
-
|
|
146
|
-
### Setup Skill (`setup-skill.md`)
|
|
147
|
-
|
|
148
|
-
| Code | Description | Source | Lines |
|
|
149
|
-
|------|-------------|--------|-------|
|
|
150
|
-
| SKL-SETUP-1 | Purpose and critical approach | setup-skill.md | 4-28 |
|
|
151
|
-
| SKL-SETUP-2 | Step 1: Scan project structure | setup-skill.md | 31-57 |
|
|
152
|
-
| SKL-SETUP-3 | Step 2: Deep dependency analysis | setup-skill.md | 58-103 |
|
|
153
|
-
| SKL-SETUP-4 | Step 3: Deep code analysis | setup-skill.md | 104-199 |
|
|
154
|
-
| SKL-SETUP-5 | Step 4: Research best practices | setup-skill.md | 200-222 |
|
|
155
|
-
| SKL-SETUP-6 | Step 5: Check existing rules | setup-skill.md | 223-249 |
|
|
156
|
-
| SKL-SETUP-7 | Step 6: Ask confirming questions (Plan mode) | setup-skill.md | 250-332 |
|
|
157
|
-
| SKL-SETUP-8 | Step 7: Generate pattern files (templates + examples) | setup-skill.md | 333-574 |
|
|
158
|
-
| SKL-SETUP-9 | Step 8: Update core pattern files | setup-skill.md | 575-605 |
|
|
159
|
-
| SKL-SETUP-10 | Step 9: Sync generic patterns to global brain | setup-skill.md | 606-654 |
|
|
160
|
-
| SKL-SETUP-11 | Step 10: Create project analysis document | setup-skill.md | 655-727 |
|
|
161
|
-
| SKL-SETUP-12 | Step 11: Index documentation files | setup-skill.md | 728-816 |
|
|
162
|
-
| SKL-SETUP-13 | Step 12: Create flow folder structure | setup-skill.md | 817-860 |
|
|
163
|
-
| SKL-SETUP-14 | Step 13: Present setup summary | setup-skill.md | 861-955 |
|
|
164
|
-
|
|
165
|
-
### Write Tests Skill (`write-tests-skill.md`)
|
|
166
|
-
|
|
167
|
-
| Code | Description | Source | Lines |
|
|
168
|
-
|------|-------------|--------|-------|
|
|
169
|
-
| SKL-TEST-1 | Purpose and inputs | write-tests-skill.md | 8-24 |
|
|
170
|
-
| SKL-TEST-2 | Workflow steps 1-3 (detect framework, coverage analysis, work queue) | write-tests-skill.md | 26-78 |
|
|
171
|
-
| SKL-TEST-3 | Step 4 (analyze source, write/improve tests, verify coverage) | write-tests-skill.md | 80-150 |
|
|
172
|
-
| SKL-TEST-4 | Step 5 and test writing guidelines | write-tests-skill.md | 152-202 |
|
|
173
|
-
| SKL-TEST-5 | Output format and final report | write-tests-skill.md | 232-283 |
|
|
174
|
-
|
|
175
|
-
---
|
|
176
|
-
|
|
177
|
-
## When to Expand
|
|
178
|
-
|
|
179
|
-
### Discovery and Planning
|
|
180
|
-
|
|
181
|
-
| Code | Expand When |
|
|
182
|
-
|------|-------------|
|
|
183
|
-
| SKL-DIS-1 | Need discovery restrictions/allowed actions |
|
|
184
|
-
| SKL-DIS-2 | Need question tracking and requirements gathering workflow |
|
|
185
|
-
| SKL-PLN-2 | Need phase structuring and complexity scoring workflow |
|
|
186
|
-
| SKL-PLN-3 | Need plan output template |
|
|
187
|
-
|
|
188
|
-
### Execution
|
|
189
|
-
|
|
190
|
-
| Code | Expand When |
|
|
191
|
-
|------|-------------|
|
|
192
|
-
| SKL-EXEC-2 | Need critical rules (build timing, DB commands) |
|
|
193
|
-
| SKL-EXEC-3 | Parsing plan file structure |
|
|
194
|
-
| SKL-EXEC-4 | Analyzing complexity, wave analysis, or determining execution strategy |
|
|
195
|
-
| SKL-EXEC-5 | Presenting execution plan summary (with wave groupings) to user |
|
|
196
|
-
| SKL-EXEC-6 | Executing a wave (parallel sub-agents) or single phase with Plan mode |
|
|
197
|
-
| SKL-EXEC-7 | Updating progress after a phase |
|
|
198
|
-
| SKL-EXEC-8 | Compacting at phase boundaries |
|
|
199
|
-
| SKL-EXEC-9 | Handling the tests phase |
|
|
200
|
-
| SKL-EXEC-10 | Final build and test verification |
|
|
201
|
-
| SKL-EXEC-11 | Need complexity-based behavior details |
|
|
202
|
-
| SKL-EXEC-12 | Handling build/test failures or cancellation |
|
|
203
|
-
|
|
204
|
-
### Code Review
|
|
205
|
-
|
|
206
|
-
| Code | Expand When |
|
|
207
|
-
|------|-------------|
|
|
208
|
-
| SKL-REV-2 | Identifying changed files for review |
|
|
209
|
-
| SKL-REV-3 | Determining review depth (adaptive) |
|
|
210
|
-
| SKL-REV-4 | Loading review patterns |
|
|
211
|
-
| SKL-REV-5 | Finding similar implementations in codebase |
|
|
212
|
-
| SKL-REV-6 | Analyzing code changes |
|
|
213
|
-
| SKL-REV-7 | Pattern conflicts, verification, and re-ranking |
|
|
214
|
-
| SKL-REV-8 | Generating the review document |
|
|
215
|
-
| SKL-REV-9 | Need severity levels and conflict resolution |
|
|
216
|
-
| SKL-REV-10 | Need search strategies for similar code |
|
|
217
|
-
| SKL-PR-2 | Authenticating for PR access |
|
|
218
|
-
| SKL-PR-3 | Fetching PR info and determining depth |
|
|
219
|
-
| SKL-PR-5 | Analyzing PR changes, verification, re-ranking |
|
|
220
|
-
| SKL-PR-6 | Generating PR review document |
|
|
221
|
-
| SKL-PR-7 | Need PR review output template |
|
|
222
|
-
| SKL-PR-8 | Need fix complexity scoring |
|
|
223
|
-
| SKL-PR-9 | Need link format for GitHub/Azure DevOps |
|
|
224
|
-
|
|
225
|
-
### Setup and Testing
|
|
226
|
-
|
|
227
|
-
| Code | Expand When |
|
|
228
|
-
|------|-------------|
|
|
229
|
-
| SKL-SETUP-2 | Scanning project structure |
|
|
230
|
-
| SKL-SETUP-3 | Deep dependency analysis |
|
|
231
|
-
| SKL-SETUP-4 | Deep code analysis |
|
|
232
|
-
| SKL-SETUP-5 | Researching best practices |
|
|
233
|
-
| SKL-SETUP-6 | Checking existing rules |
|
|
234
|
-
| SKL-SETUP-7 | Asking confirming questions via Plan mode |
|
|
235
|
-
| SKL-SETUP-8 | Generating pattern files |
|
|
236
|
-
| SKL-SETUP-9 | Updating core pattern files |
|
|
237
|
-
| SKL-SETUP-10 | Syncing to global brain |
|
|
238
|
-
| SKL-SETUP-11 | Creating project analysis document |
|
|
239
|
-
| SKL-SETUP-12 | Indexing documentation files |
|
|
240
|
-
| SKL-SETUP-13 | Creating flow folder structure |
|
|
241
|
-
| SKL-SETUP-14 | Presenting setup summary |
|
|
242
|
-
| SKL-TEST-2 | Need coverage analysis workflow |
|
|
243
|
-
| SKL-TEST-4 | Need test writing guidelines |
|
|
244
|
-
|
|
245
|
-
### Contracts
|
|
246
|
-
|
|
247
|
-
| Code | Expand When |
|
|
248
|
-
|------|-------------|
|
|
249
|
-
| SKL-CON-2 | Need contract creation workflow |
|
|
250
|
-
| SKL-CON-3 | Need contract output template |
|
|
251
|
-
|
|
252
|
-
---
|
|
253
|
-
|
|
254
|
-
## Quick Reference by Command
|
|
255
|
-
|
|
256
|
-
| Command | Skill | Key Codes |
|
|
257
|
-
|---------|-------|-----------|
|
|
258
|
-
| `/brainstorm` | brainstorm-skill | SKL-BS-1 through SKL-BS-3 |
|
|
259
|
-
| `/note` | brain-skill | SKL-BR-1 through SKL-BR-3 |
|
|
260
|
-
| `/flow cost` | flow-cost | SKL-COST-1 through SKL-COST-4 |
|
|
261
|
-
| `/learn` | learn-skill | SKL-LRN-1 through SKL-LRN-4 |
|
|
262
|
-
| `/discovery-plan` | discovery-skill | SKL-DIS-1 through SKL-DIS-4 |
|
|
263
|
-
| `/create-plan` | create-plan-skill | SKL-PLN-1 through SKL-PLN-4 |
|
|
264
|
-
| `/execute-plan` | execute-plan-skill | SKL-EXEC-1 through SKL-EXEC-12 |
|
|
265
|
-
| `/review-code` | review-code-skill | SKL-REV-1 through SKL-REV-11 |
|
|
266
|
-
| `/review-pr` | review-pr-skill | SKL-PR-1 through SKL-PR-10 |
|
|
267
|
-
| `/setup` | setup-skill | SKL-SETUP-1 through SKL-SETUP-14 |
|
|
268
|
-
| `/write-tests` | write-tests-skill | SKL-TEST-1 through SKL-TEST-5 |
|
|
269
|
-
| `/create-contract` | create-contract-skill | SKL-CON-1 through SKL-CON-4 |
|
|
270
|
-
|
|
271
|
-
---
|
|
272
|
-
|
|
273
|
-
## Skill Complexity
|
|
274
|
-
|
|
275
|
-
| Skill | Lines | Sections | Complexity |
|
|
276
|
-
|-------|-------|----------|------------|
|
|
277
|
-
| setup-skill | 955 | 14 | Highest - deep project analysis |
|
|
278
|
-
| review-pr-skill | 552 | 10 | High - multi-platform support |
|
|
279
|
-
| execute-plan-skill | 448 | 12 | High - phase execution logic |
|
|
280
|
-
| review-code-skill | 392 | 11 | Medium - pattern matching |
|
|
281
|
-
| discovery-skill | 295 | 4 | Medium - requirements gathering |
|
|
282
|
-
| brainstorm-skill | 280 | 3 | Medium - structured exploration with interactive questions |
|
|
283
|
-
| write-tests-skill | 294 | 5 | Medium - iterative testing |
|
|
284
|
-
| create-plan-skill | 271 | 4 | Low - plan structuring |
|
|
285
|
-
| learn-skill | 185 | 4 | Medium - pattern extraction + teaching mode |
|
|
286
|
-
| flow-cost | 195 | 4 | Low - JSONL parsing and reporting |
|
|
287
|
-
| create-contract-skill | 239 | 4 | Low - contract generation |
|
|
@@ -1,110 +0,0 @@
|
|
|
1
|
-
|
|
2
|
-
# Tools Index
|
|
3
|
-
|
|
4
|
-
This index provides reference codes for all tool documentation. Load specific sections on-demand using the line ranges.
|
|
5
|
-
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
## Overview
|
|
9
|
-
|
|
10
|
-
| File | Lines | Description |
|
|
11
|
-
|------|-------|-------------|
|
|
12
|
-
| auth-pr-tool.md | 363 | PR authentication for GitHub/Azure DevOps |
|
|
13
|
-
| interactive-questions-tool.md | 338 | Interactive questions via Plan mode |
|
|
14
|
-
| jest-testing-tool.md | 97 | Jest test commands for JS/TS |
|
|
15
|
-
| plan-mode-tool.md | 230 | Plan mode switching for collaborative execution |
|
|
16
|
-
| pytest-testing-tool.md | 145 | Pytest commands for Python |
|
|
17
|
-
| reference-expansion-tool.md | 219 | Reference code expansion system |
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
## Reference Codes
|
|
22
|
-
|
|
23
|
-
### TLS-AUTH: PR Authentication Tool
|
|
24
|
-
|
|
25
|
-
| Code | Lines | Description |
|
|
26
|
-
|------|-------|-------------|
|
|
27
|
-
| TLS-AUTH-1 | 1-41 | Purpose, usage, and environment configuration |
|
|
28
|
-
| TLS-AUTH-2 | 42-142 | Authentication workflow (detect, load, auth, verify, handle errors) |
|
|
29
|
-
| TLS-AUTH-3 | 144-198 | Authentication methods (GitHub CLI, Azure CLI, curl) |
|
|
30
|
-
| TLS-AUTH-4 | 199-224 | Allowed commands for GitHub and Azure DevOps |
|
|
31
|
-
| TLS-AUTH-5 | 225-250 | Security notes and required scopes |
|
|
32
|
-
| TLS-AUTH-6 | 251-363 | Usage examples and error handling |
|
|
33
|
-
|
|
34
|
-
### TLS-IQ: Interactive Questions Tool
|
|
35
|
-
|
|
36
|
-
| Code | Lines | Description |
|
|
37
|
-
|------|-------|-------------|
|
|
38
|
-
| TLS-IQ-1 | 1-38 | Purpose, usage, and critical instructions |
|
|
39
|
-
| TLS-IQ-2 | 40-82 | Step 1: Switch to Plan Mode |
|
|
40
|
-
| TLS-IQ-3 | 84-146 | Step 2: Ask Questions using AskQuestion tool |
|
|
41
|
-
| TLS-IQ-4 | 148-195 | Steps 3-5: Wait, Process, Return to Agent mode |
|
|
42
|
-
| TLS-IQ-5 | 197-228 | Complete workflow example |
|
|
43
|
-
| TLS-IQ-6 | 230-288 | When to use and question format guidelines |
|
|
44
|
-
| TLS-IQ-7 | 290-338 | Error handling and related tools |
|
|
45
|
-
|
|
46
|
-
### TLS-JEST: Jest Testing Tool
|
|
47
|
-
|
|
48
|
-
| Code | Lines | Description |
|
|
49
|
-
|------|-------|-------------|
|
|
50
|
-
| TLS-JEST-1 | 1-48 | Purpose, usage, and running tests |
|
|
51
|
-
| TLS-JEST-2 | 50-67 | Coverage commands |
|
|
52
|
-
| TLS-JEST-3 | 69-82 | Debugging tests |
|
|
53
|
-
| TLS-JEST-4 | 84-97 | CI/CD commands |
|
|
54
|
-
|
|
55
|
-
### TLS-PLN: Plan Mode Tool
|
|
56
|
-
|
|
57
|
-
| Code | Lines | Description |
|
|
58
|
-
|------|-------|-------------|
|
|
59
|
-
| TLS-PLN-1 | 1-68 | Purpose, usage, and how to switch |
|
|
60
|
-
| TLS-PLN-2 | 70-127 | Plan mode workflow (steps 1-5) |
|
|
61
|
-
| TLS-PLN-3 | 129-145 | When to use Plan mode |
|
|
62
|
-
| TLS-PLN-4 | 147-157 | Integration with Execute Plan command |
|
|
63
|
-
| TLS-PLN-5 | 159-192 | Benefits and error handling |
|
|
64
|
-
| TLS-PLN-6 | 194-230 | Complete workflow example |
|
|
65
|
-
|
|
66
|
-
### TLS-PYTEST: Pytest Testing Tool
|
|
67
|
-
|
|
68
|
-
| Code | Lines | Description |
|
|
69
|
-
|------|-------|-------------|
|
|
70
|
-
| TLS-PYTEST-1 | 1-55 | Purpose, usage, and running tests |
|
|
71
|
-
| TLS-PYTEST-2 | 57-76 | Coverage commands |
|
|
72
|
-
| TLS-PYTEST-3 | 78-99 | Debugging tests |
|
|
73
|
-
| TLS-PYTEST-4 | 101-124 | CI/CD commands |
|
|
74
|
-
| TLS-PYTEST-5 | 126-145 | Test selection |
|
|
75
|
-
|
|
76
|
-
### TLS-REF: Reference Expansion Tool
|
|
77
|
-
|
|
78
|
-
| Code | Lines | Description |
|
|
79
|
-
|------|-------|-------------|
|
|
80
|
-
| TLS-REF-1 | 1-38 | Purpose and reference code system |
|
|
81
|
-
| TLS-REF-2 | 40-74 | Expansion workflow (load, identify, expand, use) |
|
|
82
|
-
| TLS-REF-3 | 76-97 | When to expand vs when to skip |
|
|
83
|
-
| TLS-REF-4 | 99-140 | Examples (discovery and execute plan) |
|
|
84
|
-
| TLS-REF-5 | 142-170 | Maintenance guidelines |
|
|
85
|
-
| TLS-REF-6 | 172-219 | Index locations and troubleshooting |
|
|
86
|
-
|
|
87
|
-
---
|
|
88
|
-
|
|
89
|
-
## When to Expand
|
|
90
|
-
|
|
91
|
-
| Task | Codes to Expand |
|
|
92
|
-
|------|-----------------|
|
|
93
|
-
| Authenticating for PR review | TLS-AUTH-2, TLS-AUTH-3 |
|
|
94
|
-
| Asking interactive questions | TLS-IQ-1, TLS-IQ-2, TLS-IQ-3 |
|
|
95
|
-
| Running Jest tests | TLS-JEST-1, TLS-JEST-2 |
|
|
96
|
-
| Running pytest tests | TLS-PYTEST-1, TLS-PYTEST-2 |
|
|
97
|
-
| Switching to Plan mode | TLS-PLN-1, TLS-PLN-2 |
|
|
98
|
-
| Understanding reference system | TLS-REF-1, TLS-REF-2 |
|
|
99
|
-
| Maintaining index files | TLS-REF-5 |
|
|
100
|
-
|
|
101
|
-
---
|
|
102
|
-
|
|
103
|
-
## Quick Reference
|
|
104
|
-
|
|
105
|
-
- **Need to authenticate?** Use TLS-AUTH-* codes
|
|
106
|
-
- **Need to ask questions?** Use TLS-IQ-* codes
|
|
107
|
-
- **Need to run JS/TS tests?** Use TLS-JEST-* codes
|
|
108
|
-
- **Need to run Python tests?** Use TLS-PYTEST-* codes
|
|
109
|
-
- **Need to switch modes?** Use TLS-PLN-* codes
|
|
110
|
-
- **Need to understand this system?** Use TLS-REF-* codes
|