@anionzo/skill 1.6.0 → 1.7.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 (34) hide show
  1. package/README.md +65 -19
  2. package/docs/design-brief.md +3 -5
  3. package/docs/knowledge-spec.md +1 -0
  4. package/i18n/README.vi.md +65 -19
  5. package/i18n/design-brief.vi.md +3 -5
  6. package/i18n/knowledge-spec.vi.md +1 -0
  7. package/knowledge/global/skill-triggering-rules.md +1 -1
  8. package/package.json +1 -1
  9. package/scripts/install-opencode-skills +197 -35
  10. package/skills/brainstorming/SKILL.md +3 -3
  11. package/skills/brainstorming/meta.yaml +0 -1
  12. package/skills/commit/meta.yaml +0 -1
  13. package/skills/debug/meta.yaml +1 -0
  14. package/skills/docs-writer/meta.yaml +2 -1
  15. package/skills/extract/SKILL.md +48 -8
  16. package/skills/extract/meta.yaml +12 -6
  17. package/skills/feature-delivery/SKILL.md +3 -1
  18. package/skills/feature-delivery/meta.yaml +2 -2
  19. package/skills/planning/SKILL.md +19 -1
  20. package/skills/planning/meta.yaml +8 -5
  21. package/skills/research/SKILL.md +33 -3
  22. package/skills/research/meta.yaml +9 -5
  23. package/skills/using-skills/SKILL.md +4 -6
  24. package/skills/using-skills/examples.md +17 -2
  25. package/skills/using-skills/meta.yaml +1 -3
  26. package/skills/verification-before-completion/meta.yaml +0 -1
  27. package/skills/go-pipeline/SKILL.md +0 -156
  28. package/skills/go-pipeline/examples.md +0 -56
  29. package/skills/go-pipeline/meta.yaml +0 -27
  30. package/skills/go-pipeline/references/output-template.md +0 -17
  31. package/skills/repo-onboarding/SKILL.md +0 -56
  32. package/skills/repo-onboarding/examples.md +0 -115
  33. package/skills/repo-onboarding/meta.yaml +0 -25
  34. package/skills/repo-onboarding/references/output-template.md +0 -24
@@ -27,4 +27,3 @@ related_skills:
27
27
  - code-review
28
28
  - debug
29
29
  - extract
30
- - go-pipeline
@@ -36,3 +36,4 @@ related_skills:
36
36
  - commit
37
37
  - verification-before-completion
38
38
  - test-driven-development
39
+ - extract
@@ -21,6 +21,7 @@ constraints:
21
21
  - prefer section edits over full rewrites
22
22
  related_skills:
23
23
  - using-skills
24
- - repo-onboarding
24
+ - research
25
25
  - feature-delivery
26
+ - extract
26
27
  - verification-before-completion
@@ -6,6 +6,8 @@ Extract reusable patterns, significant decisions, and failure learnings from com
6
6
 
7
7
  This skill exists to turn individual task outcomes into organizational memory — not just code patterns, but also the decisions and mistakes that are expensive to repeat.
8
8
 
9
+ It also covers session handoff when work is not yet complete: compress the active task state into the smallest high-signal baton pass so a new session can continue without rereading everything.
10
+
9
11
  ## When To Use
10
12
 
11
13
  Load this skill when:
@@ -15,16 +17,45 @@ Load this skill when:
15
17
  - a decision was made that future work should know about
16
18
  - a mistake was made that should not be repeated
17
19
  - the user says "extract learnings", "document what we learned", or "capture this pattern"
20
+ - the user asks "what did we do so far?" or "summarize where we are"
21
+ - work is being handed to another session or agent
22
+ - the current session is approaching its context limit
18
23
 
19
- Skip this skill when work was routine with no surprises or novel patterns.
24
+ Skip this skill when work was routine with no surprises, novel patterns, or meaningful in-progress state to carry forward.
20
25
 
21
26
  ## Workflow
22
27
 
23
- 1. Identify the source of knowledge (completed task, code change, debugging session).
24
- 2. Analyze across three categories: patterns, decisions, and failures.
25
- 3. Check for existing documentation that should be updated (avoid duplicates).
26
- 4. Create or update knowledge documentation.
27
- 5. Promote critical learnings that would save significant time if known in advance.
28
+ 1. Identify the source of value:
29
+ - completed task or debugging session -> durable learning extraction
30
+ - unfinished task or near-full context -> session handoff
31
+ 2. If extracting durable knowledge, analyze across three categories: patterns, decisions, and failures.
32
+ 3. If preparing a handoff, compress the active task into: goal, done so far, current state, locked decisions, open risks, and next best action.
33
+ 4. Check for existing documentation that should be updated (avoid duplicates).
34
+ 5. Create or update the right artifact:
35
+ - durable knowledge documentation
36
+ - temporary handoff summary
37
+ 6. Promote critical learnings that would save significant time if known in advance.
38
+
39
+ ## Session Handoff Mode
40
+
41
+ When the task is not complete, create a high-signal baton pass for the next session.
42
+
43
+ Include:
44
+
45
+ - **Goal** — what is actively being worked on
46
+ - **Done So Far** — completed changes, validation, commits, and approved decisions
47
+ - **Current State** — what is verified, what is still in progress, and any dirty worktree notes
48
+ - **Locked Decisions** — decisions that should not be re-litigated unless the user reopens them
49
+ - **Open Questions / Risks** — blockers, uncertainty, or easy-to-miss constraints
50
+ - **Next Best Action** — the single clearest next step
51
+ - **Handoff Payload** — a compact 5-15 line summary for copy-paste into a new session
52
+
53
+ Compression rules:
54
+
55
+ - include only details that save meaningful time in the next session
56
+ - prefer concrete file paths, commands, commits, and verification state when relevant
57
+ - do not replay the whole conversation
58
+ - keep temporary task state separate from durable knowledge
28
59
 
29
60
  ## Three-Category Analysis
30
61
 
@@ -126,12 +157,14 @@ Present results using the Shared Output Contract:
126
157
 
127
158
  1. **Goal/Result** — what knowledge was extracted, updated, or intentionally not extracted
128
159
  2. **Key Details:**
129
- - what was extracted (patterns, decisions, failures)
160
+ - what was extracted or handed off
161
+ - whether this was durable knowledge or temporary task state
130
162
  - whether docs were created or updated
131
163
  - whether critical learnings were promoted
132
164
  - where the canonical knowledge now lives
133
165
  3. **Next Action** — only when findings lead somewhere:
134
166
  - extracted from completed task → `commit` if changes pending
167
+ - task is not complete but should continue later → name the primary next skill
135
168
  - no clear handoff → stop after the result
136
169
 
137
170
  ## No-Op Case
@@ -141,6 +174,7 @@ If the work was too routine to generalize, say so explicitly and do not force a
141
174
  ## Red Flags
142
175
 
143
176
  - only extracting code patterns, ignoring decisions and failures
177
+ - replaying the full session instead of compressing it
144
178
  - promoting everything as critical (noise kills the learning loop)
145
179
  - writing generic learnings like "test more carefully" (worthless)
146
180
  - fabricating findings when the task was straightforward
@@ -150,6 +184,7 @@ If the work was too routine to generalize, say so explicitly and do not force a
150
184
  ## Checklist
151
185
 
152
186
  - [ ] Three categories analyzed (patterns, decisions, failures)
187
+ - [ ] Or handoff state compressed (goal, done, current state, risks, next action)
153
188
  - [ ] Existing docs checked for duplicates
154
189
  - [ ] Knowledge is genuinely generalizable
155
190
  - [ ] Includes concrete examples (for patterns)
@@ -158,4 +193,9 @@ If the work was too routine to generalize, say so explicitly and do not force a
158
193
 
159
194
  ## Done Criteria
160
195
 
161
- This skill is complete when the three-category analysis is done and any findings worth preserving are documented in the appropriate location. If nothing worth extracting was found, an explicit "no-op" statement is the valid completion.
196
+ This skill is complete when either:
197
+
198
+ - the three-category analysis is done and any durable findings worth preserving are documented in the appropriate location, or
199
+ - the in-progress task has been compressed into a clear handoff that a new session can continue from without redoing expensive analysis.
200
+
201
+ If nothing worth extracting or handing off was found, an explicit "no-op" statement is the valid completion.
@@ -1,25 +1,31 @@
1
1
  name: extract
2
- version: 0.1.0
2
+ version: 0.2.0
3
3
  category: knowledge
4
- summary: Extract reusable patterns, decisions, and failure learnings from completed work to compound knowledge.
5
- summary_vi: "Tr\xEDch xu\u1EA5t pattern, quy\u1EBFt \u0111\u1ECBnh, v\xE0 b\xE0i h\u1ECDc t\u1EEB c\xF4ng vi\u1EC7c ho\xE0n th\xE0nh \u0111\u1EC3 t\xEDch l\u0169y ki\u1EBFn th\u1EE9c."
4
+ summary: Extract durable learnings from completed work, or compress in-progress task state into a high-signal handoff for the next session.
5
+ summary_vi: "Trích xuất bài học bền vững từ công việc đã xong, hoặc nén trạng thái công việc đang dở thành handoff sắc gọn cho session tiếp theo."
6
6
  triggers:
7
7
  - extract learnings from this task
8
8
  - document what we learned
9
9
  - capture this pattern
10
10
  - what did we learn
11
+ - what did we do so far
12
+ - summarize where we are
13
+ - prepare a handoff
14
+ - context is getting full
11
15
  inputs:
12
- - completed task or feature
13
- - code changes or debugging session
16
+ - completed task, unfinished task, or feature
17
+ - code changes, debugging session, or current task state
14
18
  outputs:
15
19
  - patterns documented
16
20
  - decisions recorded
17
21
  - failures captured
18
22
  - critical learnings promoted
23
+ - handoff payload for the next session
19
24
  constraints:
20
25
  - search existing docs before creating new ones
21
26
  - do not fabricate findings
22
- - three-category analysis required
27
+ - use three-category analysis for durable knowledge
28
+ - compress instead of replaying the whole session for handoffs
23
29
  related_skills:
24
30
  - using-skills
25
31
  - commit
@@ -28,7 +28,7 @@ Present results using the Shared Output Contract:
28
28
  - files changed
29
29
  - verification performed
30
30
  - follow-up or risk note
31
- 3. **Next Action** — `verification-before-completion` to confirm, then `code-review` or `commit`
31
+ 3. **Next Action** — `verification-before-completion` to confirm, then `code-review` or `commit`; if pausing mid-task, use `extract` in handoff mode
32
32
 
33
33
  ## Red Flags
34
34
 
@@ -42,3 +42,5 @@ Present results using the Shared Output Contract:
42
42
  This skill is complete when the feature works as intended, the change is verified with the most relevant check available, and the outcome is summarized clearly.
43
43
 
44
44
  Before declaring done, run `verification-before-completion` to confirm the claim is backed by fresh evidence.
45
+
46
+ If the task must pause before completion, use `extract` in handoff mode so the next session can resume without repeating the implementation analysis.
@@ -22,10 +22,10 @@ related_skills:
22
22
  - using-skills
23
23
  - brainstorming
24
24
  - planning
25
- - repo-onboarding
25
+ - research
26
26
  - debug
27
27
  - verification-before-completion
28
28
  - code-review
29
29
  - docs-writer
30
- - go-pipeline
30
+ - extract
31
31
  - test-driven-development
@@ -6,6 +6,8 @@ Produce an execution-ready plan before code changes begin. Each step must be con
6
6
 
7
7
  This skill exists to make planning explicit, especially for multi-file or non-trivial work.
8
8
 
9
+ It also covers go mode when the user wants an approved spec or clear task executed end-to-end with minimal review gates.
10
+
9
11
  ## When To Use
10
12
 
11
13
  Load this skill when:
@@ -15,6 +17,7 @@ Load this skill when:
15
17
  - the change touches APIs, data flow, persistence, or architecture boundaries
16
18
  - the user explicitly asks for a plan
17
19
  - implementation risk is high enough that code should not start immediately
20
+ - the user says "run all", "go mode", "execute everything", or wants one continuous plan-to-commit flow
18
21
 
19
22
  ## Workflow
20
23
 
@@ -30,6 +33,20 @@ Load this skill when:
30
33
  10. Present for approval.
31
34
  11. End with the next implementation skill to invoke.
32
35
 
36
+ ## Go Mode
37
+
38
+ When the user wants an approved spec or clear task executed with minimal review gates, planning enters go mode:
39
+
40
+ 1. Validate that requirements are clear enough to implement.
41
+ 2. Break the work into ordered implementation tasks.
42
+ 3. Map each task to acceptance criteria or explicit outcomes.
43
+ 4. Plan and execute each task in dependency order.
44
+ 5. Verify after each task.
45
+ 6. Run full verification at the end.
46
+ 7. Prepare a single commit proposal and ask the user before committing.
47
+
48
+ If the scope is too large for one context window, checkpoint progress and resume later rather than continuing blindly.
49
+
33
50
  ## Bite-Sized Task Granularity
34
51
 
35
52
  Each step should be one action, completable in 2-5 minutes:
@@ -122,6 +139,7 @@ Present results using the Shared Output Contract:
122
139
  - `feature-delivery` for implementation
123
140
  - `test-driven-development` if TDD approach preferred
124
141
  - `brainstorming` if requirements need more definition first
142
+ - if the user wants one continuous execution run: continue in go mode under `planning`
125
143
 
126
144
  ## Planning Rules
127
145
 
@@ -169,4 +187,4 @@ Present results using the Shared Output Contract:
169
187
 
170
188
  ## Done Criteria
171
189
 
172
- This skill is complete when the implementation path, risks, and verification steps are clear enough to hand off to `feature-delivery`, `refactor-safe`, or `test-driven-development`. The pre-execution check and self-review must have been run with all findings addressed or explicitly surfaced.
190
+ This skill is complete when the implementation path, risks, and verification steps are clear enough to hand off to `feature-delivery`, `refactor-safe`, or `test-driven-development` — or, in go mode, when the work has been planned, executed, verified, and brought to a commit gate. The pre-execution check and self-review must have been run with all findings addressed or explicitly surfaced.
@@ -1,16 +1,20 @@
1
1
  name: planning
2
- version: 0.3.0
2
+ version: 0.4.0
3
3
  category: planning
4
- summary: Execution-ready plans with bite-sized steps, no placeholders, self-review, and pre-execution validation.
5
- summary_vi: "Plan sẵn sàng thực thi với bước nhỏ gọn, không placeholder, tự review, kiểm tra trước thực thi."
4
+ summary: Execution-ready plans with bite-sized steps, no placeholders, self-review, pre-execution validation, and optional go-mode execution.
5
+ summary_vi: "Plan sẵn sàng thực thi với bước nhỏ gọn, không placeholder, tự review, kiểm tra trước thực thi, và có thể chạy theo go mode."
6
6
  triggers:
7
7
  - make a plan
8
8
  - think through the implementation first
9
9
  - prepare before coding
10
+ - run all
11
+ - go mode
12
+ - execute everything
10
13
  inputs:
11
14
  - user request
12
15
  - relevant repo context
13
16
  - existing patterns and constraints
17
+ - optional approved spec or explicit requirements
14
18
  outputs:
15
19
  - scope (in/out)
16
20
  - approach
@@ -18,6 +22,7 @@ outputs:
18
22
  - pre-execution check results
19
23
  - self-review results
20
24
  - verification plan
25
+ - optional go-mode task execution and commit proposal
21
26
  constraints:
22
27
  - keep the plan concrete and bounded
23
28
  - separate planning from implementation
@@ -27,12 +32,10 @@ constraints:
27
32
  related_skills:
28
33
  - using-skills
29
34
  - brainstorming
30
- - repo-onboarding
31
35
  - research
32
36
  - debug
33
37
  - feature-delivery
34
38
  - refactor-safe
35
39
  - code-review
36
40
  - test-driven-development
37
- - go-pipeline
38
41
  - verification-before-completion
@@ -2,19 +2,23 @@
2
2
 
3
3
  ## Purpose
4
4
 
5
- Understand existing code, patterns, and decisions before writing new code.
5
+ Understand existing code, patterns, decisions, and repository structure before writing new code.
6
6
 
7
7
  This skill exists to prevent implementing from scratch what already exists, and to surface constraints that would otherwise be discovered mid-implementation.
8
8
 
9
+ It also covers repo onboarding: mapping a repository quickly enough to act safely when the task starts from little context.
10
+
9
11
  ## When To Use
10
12
 
11
13
  Load this skill when:
12
14
 
13
15
  - exploring a codebase before starting a task
16
+ - entering a repo for the first time
14
17
  - looking for existing patterns, utilities, or conventions to follow
15
18
  - trying to understand how a feature or subsystem works
16
19
  - the implementation approach depends on what already exists
17
20
  - the user says "research this", "look into", or "what do we have for X"
21
+ - the user asks "explain this repo" or "understand this codebase before we change it"
18
22
 
19
23
  Skip this skill when you already have clear context and the task is straightforward.
20
24
 
@@ -31,7 +35,32 @@ Skip this skill when you already have clear context and the task is straightforw
31
35
  - whether it is reusable, needs adaptation, or is irrelevant
32
36
  - any conventions or constraints it reveals
33
37
  4. Identify gaps — what does NOT exist that the task needs.
34
- 5. Summarize findings with concrete recommendations.
38
+ 5. If this is repo onboarding, also identify:
39
+ - project purpose
40
+ - major components and responsibilities
41
+ - runtime model and key integrations
42
+ - important development commands
43
+ - notable conventions and open questions
44
+ 6. Summarize findings with concrete recommendations.
45
+
46
+ ## Repo Onboarding Mode
47
+
48
+ When the user is entering an unfamiliar repo, use research in repo-map mode:
49
+
50
+ 1. Read the top-level operating docs first, especially `AGENTS.md` and `README.md` when present.
51
+ 2. Inspect the most informative files next:
52
+ - package manifests or build files
53
+ - app entrypoints and framework bootstraps
54
+ - core config files
55
+ - representative tests
56
+ 3. Summarize:
57
+ - project purpose
58
+ - architecture summary
59
+ - major components
60
+ - important commands
61
+ - notable conventions or constraints
62
+ - open questions
63
+ 4. Recommend the next files or directories to inspect for the user's likely goal.
35
64
 
36
65
  ## Search Techniques
37
66
 
@@ -66,6 +95,7 @@ Present findings using the Shared Output Contract:
66
95
  3. **Next Action** — recommend a follow-up only when findings clearly lead somewhere:
67
96
  - research for an active task → `planning`
68
97
  - research revealed a gap → `brainstorming`
98
+ - research produced enough repo context → `planning`, `docs-writer`, or direct execution
69
99
  - no clear handoff → stop after findings
70
100
 
71
101
  ## Research Rules
@@ -97,4 +127,4 @@ Present findings using the Shared Output Contract:
97
127
 
98
128
  ## Done Criteria
99
129
 
100
- This skill is complete when the findings are concrete enough to inform the next step — whether that is planning, implementation, or a decision that more information is needed. Every finding should include a file path or explicit "not found" statement.
130
+ This skill is complete when the findings are concrete enough to inform the next step — whether that is planning, implementation, docs work, or a decision that more information is needed. Every finding should include a file path or explicit "not found" statement.
@@ -1,21 +1,25 @@
1
1
  name: research
2
- version: 0.1.0
2
+ version: 0.2.0
3
3
  category: discovery
4
- summary: Understand existing code, patterns, and decisions before writing new code to avoid reinventing what exists.
5
- summary_vi: "T\xECm hi\u1EC3u code, pattern, v\xE0 quy\u1EBFt \u0111\u1ECBnh hi\u1EC7n c\xF3 tr\u01B0\u1EDBc khi vi\u1EBFt code m\u1EDBi \u0111\u1EC3 tr\xE1nh l\xE0m l\u1EA1i nh\u1EEFng g\xEC \u0111\xE3 c\xF3."
4
+ summary: Understand repository structure, existing code, patterns, and decisions before acting so new work follows what already exists.
5
+ summary_vi: "Tìm hiểu cấu trúc repo, code, pattern, quyết định hiện trước khi hành động để công việc mới đi đúng theo cái đã có."
6
6
  triggers:
7
7
  - research this codebase
8
8
  - what do we already have for X
9
9
  - look into how this works
10
10
  - explore before implementing
11
+ - explain this repo
12
+ - onboard into a codebase
13
+ - understand architecture before changing code
11
14
  inputs:
12
- - topic or feature to research
15
+ - topic, feature, or repository area to research
13
16
  - optional file paths or package names
14
17
  outputs:
15
18
  - existing implementations found
16
19
  - patterns and conventions discovered
17
20
  - gaps identified
18
21
  - actionable recommendations
22
+ - repo map and important commands when onboarding
19
23
  constraints:
20
24
  - search before assuming nothing exists
21
25
  - read actual code not just filenames
@@ -24,4 +28,4 @@ related_skills:
24
28
  - planning
25
29
  - brainstorming
26
30
  - extract
27
- - repo-onboarding
31
+ - docs-writer
@@ -34,7 +34,6 @@ If the user types `an:<skill-name>` (for example `an:planning` or `an:debug`), s
34
34
  **Available skills:**
35
35
 
36
36
  - `an:brainstorming` — explore ideas, lock decisions, optionally write a spec
37
- - `an:repo-onboarding` — understand an unfamiliar codebase
38
37
  - `an:research` — explore existing code and patterns before implementing
39
38
  - `an:planning` — create an execution-ready plan with bite-sized steps
40
39
  - `an:feature-delivery` — implement a feature
@@ -46,7 +45,6 @@ If the user types `an:<skill-name>` (for example `an:planning` or `an:debug`), s
46
45
  - `an:commit` — create a conventional commit with verification
47
46
  - `an:docs-writer` — update documentation
48
47
  - `an:extract` — extract patterns, decisions, and learnings from completed work
49
- - `an:go-pipeline` — execute a full spec-to-commit pipeline in one run
50
48
 
51
49
  ## Workflow
52
50
 
@@ -69,20 +67,20 @@ If the user types `an:<skill-name>` (for example `an:planning` or `an:debug`), s
69
67
 
70
68
  - `an:<skill-name>` (direct trigger) -> load the named skill immediately
71
69
  - vague feature idea, unclear goal, tradeoff exploration -> `brainstorming`, then `planning`
72
- - unfamiliar repo or missing context -> `repo-onboarding`
70
+ - unfamiliar repo or missing context -> `research`
73
71
  - need to understand existing code before implementing -> `research`
74
72
  - complex feature needing requirements definition -> `brainstorming` (includes spec writing)
75
- - docs work in an unfamiliar repo -> `repo-onboarding` first, then `docs-writer`
73
+ - docs work in an unfamiliar repo -> `research` first, then `docs-writer`
76
74
  - bug report, error trace, failing test, regression -> `debug`
77
75
  - implement or change behavior -> `planning`, then `feature-delivery`
78
76
  - implement with TDD approach -> `planning`, then `test-driven-development`
77
+ - execute an approved spec or clear task end-to-end with minimal gates -> `planning` in go mode
79
78
  - refactor, restructure, extract, or migrate without behavior change -> `planning`, then `refactor-safe`
80
79
  - review diff, PR, or changed files -> `code-review`
81
80
  - respond to review feedback -> `code-review` (receiving mode)
82
81
  - ready to commit -> `commit`
83
82
  - update README, runbook, onboarding docs, API notes in a known repo -> `docs-writer`
84
- - extract learnings from completed work -> `extract`
85
- - execute an approved spec end-to-end -> `go-pipeline`
83
+ - extract learnings from completed work, or summarize active work for the next session -> `extract`
86
84
 
87
85
  ## Planning Rule
88
86
 
@@ -41,7 +41,7 @@ Help me understand this repo before we add a new API endpoint.
41
41
  Expected routing:
42
42
 
43
43
  - task type: repo understanding
44
- - chosen skill: `repo-onboarding`
44
+ - chosen skill: `research`
45
45
  - planning required: not yet
46
46
  - next step: read repo docs and inspect core entrypoints
47
47
 
@@ -60,7 +60,22 @@ Expected routing:
60
60
  - planning required: yes
61
61
  - next step: refine the exact SSO scope and constraints before writing the implementation plan
62
62
 
63
- ## Example 5 — Sample completed output
63
+ ## Example 5
64
+
65
+ User request:
66
+
67
+ ```text
68
+ What did we do so far? Prepare the next session to continue this task.
69
+ ```
70
+
71
+ Expected routing:
72
+
73
+ - task type: extraction / handoff
74
+ - chosen skill: `extract`
75
+ - planning required: no
76
+ - next step: summarize the active task, completed work, locked decisions, risks, and next action
77
+
78
+ ## Example 6 — Sample completed output
64
79
 
65
80
  User request:
66
81
 
@@ -1,5 +1,5 @@
1
1
  name: using-skills
2
- version: 0.3.0
2
+ version: 0.4.0
3
3
  category: routing
4
4
  summary: Route a user request to the right primary skill and working mode before deeper work begins.
5
5
  summary_vi: "Phân loại request và chọn đúng skill chính trước khi bắt đầu công việc sâu hơn."
@@ -19,7 +19,6 @@ constraints:
19
19
  - prefer one primary skill at a time
20
20
  related_skills:
21
21
  - brainstorming
22
- - repo-onboarding
23
22
  - research
24
23
  - planning
25
24
  - test-driven-development
@@ -31,4 +30,3 @@ related_skills:
31
30
  - verification-before-completion
32
31
  - docs-writer
33
32
  - extract
34
- - go-pipeline
@@ -30,7 +30,6 @@ related_skills:
30
30
  - docs-writer
31
31
  - feature-delivery
32
32
  - debug
33
- - go-pipeline
34
33
  - planning
35
34
  - refactor-safe
36
35
  - test-driven-development
@@ -1,156 +0,0 @@
1
- # Go Pipeline
2
-
3
- ## Purpose
4
-
5
- Execute a full development pipeline from an approved spec: break into tasks, plan each, implement each, verify all, and commit — in one continuous run with minimal review gates.
6
-
7
- This skill exists for when the spec is approved and the user wants execution, not incremental review at each step.
8
-
9
- ## When To Use
10
-
11
- Load this skill when:
12
-
13
- - the user has an approved spec and wants to execute everything in one shot
14
- - the user says "run all", "go mode", "execute everything", or "just build it"
15
- - all requirements are clear and decisions are locked
16
-
17
- ## When NOT To Use
18
-
19
- - Spec is still a draft — redirect to `brainstorming` first.
20
- - User wants to review each task individually — use `planning` + `feature-delivery` per task.
21
- - Spec has unresolved open questions — resolve them first.
22
- - The scope is too large for one context window — use `planning` + `feature-delivery` incrementally.
23
-
24
- ## Workflow
25
-
26
- ### Phase 1: Validate Spec
27
-
28
- Before starting, verify the spec is ready:
29
-
30
- - [ ] Spec exists and is approved
31
- - [ ] Has acceptance criteria defined
32
- - [ ] No unresolved blocking questions
33
- - [ ] Requirements are specific enough to implement
34
-
35
- If any check fails, STOP and redirect:
36
- > "Spec not ready. [specific issue]. Run `brainstorming` first."
37
-
38
- ### Phase 2: Generate Tasks
39
-
40
- Parse the spec and break it into ordered implementation tasks:
41
-
42
- - Group related requirements into logical tasks
43
- - Order by dependency (foundational first, dependent last)
44
- - Each task should be completable in a single implementation session
45
- - Map each task to the spec acceptance criteria it fulfills
46
-
47
- **Report:** "Created X tasks from spec. Starting implementation..."
48
-
49
- ### Phase 3: Plan + Implement Each Task
50
-
51
- Loop through all tasks in dependency order:
52
-
53
- For each task:
54
- 1. **Research context** — check related code, patterns, docs
55
- 2. **Draft plan** — concrete steps, files to change, tests to add
56
- 3. **Implement** — work through plan steps
57
- 4. **Verify** — run tests/lint/build after each task
58
- 5. **Mark complete** — note what was done
59
-
60
- **Progress report between tasks:**
61
- > "Task X/Y done: [title]. Continuing..."
62
-
63
- ### Phase 4: Full Verification
64
-
65
- After all tasks complete:
66
-
67
- 1. Run the full test suite
68
- 2. Run the build
69
- 3. Run linting
70
- 4. Check acceptance criteria coverage:
71
-
72
- ```
73
- Coverage Report
74
- ===============
75
- Spec: [name]
76
- Tasks: X/X complete (100%)
77
- ACs: Y/Z verified
78
- ```
79
-
80
- If coverage < 100%, identify and address gaps.
81
-
82
- ### Phase 5: Commit
83
-
84
- Stage all changes and prepare a single conventional commit:
85
-
86
- ```
87
- feat(<scope>): implement <spec-name>
88
-
89
- - Task 1: <title>
90
- - Task 2: <title>
91
- - All ACs verified
92
- ```
93
-
94
- **This is the ONE gate in go-pipeline — ask user before committing:**
95
-
96
- > Pipeline complete. X tasks done, all verified.
97
- > Ready to commit. Proceed? (yes / no / edit)
98
-
99
- ## Context Budget Management
100
-
101
- If context exceeds approximately 60% during implementation:
102
-
103
- 1. Finish the current task
104
- 2. Commit completed work so far
105
- 3. Report progress and remaining tasks
106
- 4. Suggest: "Run `go-pipeline` again to continue remaining tasks."
107
-
108
- The skill should detect already-completed tasks and skip them on re-run.
109
-
110
- ## Error Handling
111
-
112
- - **Build/test fails during a task:** Fix the error, re-run tests. If unfixable, mark task as blocked, note why, continue to next task.
113
- - **Spec has conflicting requirements:** STOP and ask user to clarify.
114
- - **Task depends on blocked task:** Skip and report at the end.
115
-
116
- ## Output Format
117
-
118
- Present results using the Shared Output Contract:
119
-
120
- 1. **Goal/Result** — what was completed across the full pipeline run
121
- 2. **Key Details:**
122
- - total tasks created and completed
123
- - any blocked or skipped tasks
124
- - acceptance criteria coverage percentage
125
- - build/test/lint status
126
- - commit proposal
127
- 3. **Next Action:**
128
- - if complete → commit confirmation
129
- - if interrupted → how to resume
130
- - if blocked → what to resolve
131
-
132
- ## Red Flags
133
-
134
- - running on a draft or unapproved spec
135
- - skipping verification between tasks
136
- - not checking acceptance criteria before marking tasks done
137
- - committing without user approval
138
- - ignoring build/test failures
139
- - not reporting progress between tasks
140
- - continuing past context budget limit without checkpointing
141
- - treating this as a shortcut to skip proper spec work
142
-
143
- ## Checklist
144
-
145
- - [ ] Spec is approved
146
- - [ ] Spec validated (requirements clear, ACs defined)
147
- - [ ] Tasks generated with AC mapping
148
- - [ ] Each task: planned, implemented, verified, completed
149
- - [ ] Full verification passed (tests, build, lint)
150
- - [ ] AC coverage reported
151
- - [ ] User approved commit
152
- - [ ] Commit created
153
-
154
- ## Done Criteria
155
-
156
- This skill is complete when all tasks from the spec are implemented, verified, and committed with user approval — or when progress is checkpointed and the user is informed how to resume.