@mrciphersmith/keryx 0.2.72 → 0.2.73
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/dist/cli.js +352 -22
- package/package.json +2 -2
- package/src/gdskills/bundled/rules/core/gproject-contracts.mdc +1 -1
- package/src/gdskills/bundled/rules/core/jobs-documentation.mdc +1 -1
- package/src/gdskills/bundled/rules/core/subagent-context-construction.md +1 -1
- package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.codex.md +326 -20
- package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.cursor.md +320 -22
- package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.opencode.md +326 -12
- package/src/gdskills/bundled/skills/orchestration/code-verifier/SKILL.zed.md +333 -9
- package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.codex.md +92 -4
- package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.cursor.md +92 -4
- package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.opencode.md +92 -4
- package/src/gdskills/bundled/skills/orchestration/context-collector/SKILL.zed.md +92 -4
- package/src/gdskills/bundled/skills/orchestration/context-collector/orchestrator-prompt.md +1 -1
- package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.codex.md +154 -1098
- package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.cursor.md +154 -1098
- package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.opencode.md +154 -1098
- package/src/gdskills/bundled/skills/orchestration/feature-analyzer/SKILL.zed.md +154 -1098
- package/src/gdskills/bundled/skills/orchestration/feature-analyzer/orchestrator-prompt.md +1 -1
- package/src/gdskills/bundled/skills/orchestration/feature-dev/SKILL.codex.md +101 -41
- package/src/gdskills/bundled/skills/orchestration/feature-dev/SKILL.cursor.md +101 -41
- package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.codex.md +115 -49
- package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.cursor.md +115 -49
- package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.opencode.md +115 -49
- package/src/gdskills/bundled/skills/orchestration/issue-analyzer/SKILL.zed.md +115 -49
- package/src/gdskills/bundled/skills/orchestration/issue-analyzer/orchestrator-prompt.md +1 -1
- package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.codex.md +15 -6
- package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.cursor.md +15 -6
- package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.opencode.md +15 -6
- package/src/gdskills/bundled/skills/orchestration/job-documenter/SKILL.zed.md +15 -6
- package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.md +1 -1
- package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.opencode.md +1 -1
- package/src/gdskills/bundled/skills/orchestration/job-orchestrator/SKILL.zed.md +1 -1
- package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.codex.md +300 -55
- package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.cursor.md +300 -55
- package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.md +120 -37
- package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.opencode.md +300 -55
- package/src/gdskills/bundled/skills/orchestration/task-implementer/SKILL.zed.md +300 -55
- package/src/gdskills/bundled/skills/orchestration/task-implementer/input-contract.schema.json +56 -14
- package/src/gdskills/bundled/skills/orchestration/task-implementer/orchestrator-prompt.md +50 -23
- package/src/gdskills/bundled/skills/orchestration/task-implementer/output-contract.schema.json +6 -2
- package/src/gdskills/bundled/skills/orchestration/task-implementer/task-request.template.md +18 -12
- package/src/gdskills/bundled/skills/planning/brainstorm/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/planning/brainstorm/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/planning/consistency-checker/SKILL.codex.md +168 -9
- package/src/gdskills/bundled/skills/planning/consistency-checker/SKILL.cursor.md +168 -9
- package/src/gdskills/bundled/skills/planning/interview/SKILL.codex.md +7 -1
- package/src/gdskills/bundled/skills/planning/interview/SKILL.cursor.md +7 -1
- package/src/gdskills/bundled/skills/planning/interviewer/SKILL.codex.md +7 -1
- package/src/gdskills/bundled/skills/planning/interviewer/SKILL.cursor.md +7 -1
- package/src/gdskills/bundled/skills/planning/patterns-researcher/SKILL.codex.md +215 -9
- package/src/gdskills/bundled/skills/planning/patterns-researcher/SKILL.cursor.md +215 -9
- package/src/gdskills/bundled/skills/planning/planner/SKILL.codex.md +168 -9
- package/src/gdskills/bundled/skills/planning/planner/SKILL.cursor.md +168 -9
- package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.codex.md +2 -2
- package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.cursor.md +2 -2
- package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.opencode.md +2 -2
- package/src/gdskills/bundled/skills/planning/prd-creator/SKILL.zed.md +2 -2
- package/src/gdskills/bundled/skills/planning/problem-definer/SKILL.codex.md +133 -9
- package/src/gdskills/bundled/skills/planning/problem-definer/SKILL.cursor.md +133 -9
- package/src/gdskills/bundled/skills/planning/project-discovery/SKILL.codex.md +145 -9
- package/src/gdskills/bundled/skills/planning/project-discovery/SKILL.cursor.md +145 -9
- package/src/gdskills/bundled/skills/planning/spec-writer/SKILL.codex.md +210 -9
- package/src/gdskills/bundled/skills/planning/spec-writer/SKILL.cursor.md +210 -9
- package/src/gdskills/bundled/skills/planning/stack-advisor/SKILL.codex.md +161 -9
- package/src/gdskills/bundled/skills/planning/stack-advisor/SKILL.cursor.md +161 -9
- package/src/gdskills/bundled/skills/platform/claude-md-management/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/platform/claude-md-management/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/platform/hookify/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/platform/hookify/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/changelog/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/changelog/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/commit/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/commit/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/db-migrate/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/db-migrate/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/dependency-update/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/dependency-update/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/deploy/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/deploy/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/perf-check/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/perf-check/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/pr/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/pr/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.codex.md +15 -1
- package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.cursor.md +248 -165
- package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.opencode.md +15 -1
- package/src/gdskills/bundled/skills/quality/pr-issue-documenter/SKILL.zed.md +359 -19
- package/src/gdskills/bundled/skills/quality/push/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/push/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/security-audit/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/security-audit/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/test-gen/SKILL.codex.md +1 -1
- package/src/gdskills/bundled/skills/quality/test-gen/SKILL.cursor.md +1 -1
- package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.codex.md +299 -24
- package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.cursor.md +296 -31
- package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.opencode.md +309 -18
- package/src/gdskills/bundled/skills/quality/tests-creator/SKILL.zed.md +312 -17
- package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.codex.md +29 -30
- package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.cursor.md +29 -30
- package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.opencode.md +29 -30
- package/src/gdskills/bundled/skills/review/code-ai-review/SKILL.zed.md +29 -30
- package/src/gdskills/bundled/skills/review/code-learned-review/SKILL.codex.md +21 -30
- package/src/gdskills/bundled/skills/review/code-learned-review/SKILL.cursor.md +21 -30
- package/src/gdskills/bundled/skills/review/code-learned-review/SKILL.opencode.md +21 -30
- package/src/gdskills/bundled/skills/review/code-learned-review/SKILL.zed.md +21 -30
- package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.codex.md +19 -23
- package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.cursor.md +19 -23
- package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.opencode.md +19 -23
- package/src/gdskills/bundled/skills/review/code-mobx-store-review/SKILL.zed.md +19 -23
- package/src/gdskills/bundled/skills/review/code-style-review/SKILL.codex.md +17 -24
- package/src/gdskills/bundled/skills/review/code-style-review/SKILL.cursor.md +17 -24
- package/src/gdskills/bundled/skills/review/code-style-review/SKILL.opencode.md +17 -24
- package/src/gdskills/bundled/skills/review/code-style-review/SKILL.zed.md +17 -24
- package/src/gdskills/bundled/skills/review/review-orchestrator/SKILL.md +16 -3
- package/src/gdskills/bundled/skills/planning/brainstorm/SKILL.claude.md +0 -46
- package/src/gdskills/bundled/skills/planning/interviewer/SKILL.claude.md +0 -94
- package/src/gdskills/bundled/skills/quality/changelog/SKILL.claude.md +0 -45
- package/src/gdskills/bundled/skills/quality/db-migrate/SKILL.claude.md +0 -40
- package/src/gdskills/bundled/skills/quality/dependency-update/SKILL.claude.md +0 -45
- package/src/gdskills/bundled/skills/quality/deploy/SKILL.claude.md +0 -42
- package/src/gdskills/bundled/skills/quality/perf-check/SKILL.claude.md +0 -48
- package/src/gdskills/bundled/skills/quality/security-audit/SKILL.claude.md +0 -40
- package/src/gdskills/bundled/skills/quality/test-gen/SKILL.claude.md +0 -30
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: issue-analyzer
|
|
3
|
-
description: "
|
|
3
|
+
description: "Use when decomposing a GitHub issue into atomic tasks for AI implementation, planning task breakdown, or preparing work for task-implementer agents."
|
|
4
4
|
triggers:
|
|
5
5
|
- "Analyze issue"
|
|
6
6
|
- "Decompose issue"
|
|
@@ -9,8 +9,9 @@ triggers:
|
|
|
9
9
|
- "Plan issue implementation"
|
|
10
10
|
metadata:
|
|
11
11
|
author: "MrCipherSmith"
|
|
12
|
-
version: "1.
|
|
12
|
+
version: "1.1.0"
|
|
13
13
|
category: "analysis"
|
|
14
|
+
agent_worthy: true
|
|
14
15
|
compatible_harnesses: "cursor,codex,zed,opencode"
|
|
15
16
|
license: "MIT"
|
|
16
17
|
---
|
|
@@ -22,7 +23,7 @@ license: "MIT"
|
|
|
22
23
|
Analyzes a GitHub issue and decomposes it into atomic implementation tasks that can be dispatched to `task-implementer` sub-agents. Designed to run autonomously as a sub-agent — no user interaction required.
|
|
23
24
|
|
|
24
25
|
**Input:** GitHub issue URL (or repo + number) + codebase path(s)
|
|
25
|
-
**Output:**
|
|
26
|
+
**Output:** JSON analysis object with one task entry per atomic task, each containing full context for implementation
|
|
26
27
|
|
|
27
28
|
## When to Use
|
|
28
29
|
|
|
@@ -36,7 +37,7 @@ Analyzes a GitHub issue and decomposes it into atomic implementation tasks that
|
|
|
36
37
|
Phase 1: COLLECT → Fetch all issue data from GitHub
|
|
37
38
|
Phase 2: ANALYZE → Extract intent, find affected code areas
|
|
38
39
|
Phase 3: DECOMPOSE → Break into atomic tasks with dependencies
|
|
39
|
-
Phase 4: FORMALIZE → Emit
|
|
40
|
+
Phase 4: FORMALIZE → Emit structured JSON analysis object
|
|
40
41
|
```
|
|
41
42
|
|
|
42
43
|
---
|
|
@@ -48,7 +49,7 @@ Issue Analyzer Progress:
|
|
|
48
49
|
- [ ] Phase 1: Collect issue data from GitHub
|
|
49
50
|
- [ ] Phase 2: Analyze intent and search codebase
|
|
50
51
|
- [ ] Phase 3: Decompose into atomic tasks
|
|
51
|
-
- [ ] Phase 4: Formalize as
|
|
52
|
+
- [ ] Phase 4: Formalize as JSON output
|
|
52
53
|
```
|
|
53
54
|
|
|
54
55
|
### Phase 1: COLLECT
|
|
@@ -201,49 +202,102 @@ TASKS:
|
|
|
201
202
|
|
|
202
203
|
### Phase 4: FORMALIZE
|
|
203
204
|
|
|
204
|
-
Convert the task list into
|
|
205
|
+
Convert the task list into a structured JSON object for reliable machine parsing.
|
|
205
206
|
|
|
206
207
|
**Output structure:**
|
|
207
208
|
|
|
208
|
-
```
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
209
|
+
```json
|
|
210
|
+
{
|
|
211
|
+
"issue": {
|
|
212
|
+
"number": "<issue_number>",
|
|
213
|
+
"title": "<issue_title>",
|
|
214
|
+
"type": "<bug|feature|enhancement|refactoring|chore>",
|
|
215
|
+
"repo": "<owner/repo>",
|
|
216
|
+
"intent": "<1-2 sentence intent summary>",
|
|
217
|
+
"labels": ["<label1>", "<label2>"],
|
|
218
|
+
"assignees": ["<user1>"],
|
|
219
|
+
"total_tasks": "<N>"
|
|
220
|
+
},
|
|
221
|
+
"tasks": [
|
|
222
|
+
{
|
|
223
|
+
"task_id": "task-1",
|
|
224
|
+
"task_name": "<Descriptive Task Name>",
|
|
225
|
+
"task_type": "<ui_component|store_logic|service_api|refactoring|fix|mixed>",
|
|
226
|
+
"complexity": "<low|medium|high>",
|
|
227
|
+
"dependencies": [],
|
|
228
|
+
"description": "<full description of what to implement>",
|
|
229
|
+
"target_files": ["src/path/file.ts"],
|
|
230
|
+
"acceptance_criteria": ["criterion 1", "criterion 2"],
|
|
231
|
+
"context": "<relevant code context, key types, function signatures>",
|
|
232
|
+
"existing_tests": ["src/path/file.test.ts"],
|
|
233
|
+
"existing_stories": [],
|
|
234
|
+
"module_patterns": "<how similar code is written in this module>",
|
|
235
|
+
"requires_tests_creator": true
|
|
236
|
+
},
|
|
237
|
+
{
|
|
238
|
+
"task_id": "task-2",
|
|
239
|
+
"task_name": "<Descriptive Task Name>",
|
|
240
|
+
"task_type": "<type>",
|
|
241
|
+
"complexity": "<low|medium|high>",
|
|
242
|
+
"dependencies": ["task-1"],
|
|
243
|
+
"description": "<description>",
|
|
244
|
+
"target_files": ["src/path/other.ts"],
|
|
245
|
+
"acceptance_criteria": ["criterion 1"],
|
|
246
|
+
"context": "<context>",
|
|
247
|
+
"existing_tests": [],
|
|
248
|
+
"existing_stories": [],
|
|
249
|
+
"module_patterns": "<patterns>",
|
|
250
|
+
"requires_tests_creator": true
|
|
251
|
+
}
|
|
252
|
+
],
|
|
253
|
+
"dependency_order": ["task-1", "task-2"]
|
|
254
|
+
}
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
**Each task object is the explicit context for task-implementer.**
|
|
258
|
+
|
|
259
|
+
When `job-orchestrator` dispatches `task-implementer`, it passes the task object directly as the subagent's context. This means:
|
|
260
|
+
- `task.context`, `task.target_files`, and `task.acceptance_criteria` are **required fields** — never omit or leave them empty when the information exists.
|
|
261
|
+
- `task.context` must contain enough information for the implementer to start without reading the full codebase: key types, function signatures, relevant patterns, and any design decisions.
|
|
262
|
+
- `task.module_patterns` must describe how similar code is written nearby — the implementer uses this for style consistency.
|
|
263
|
+
|
|
264
|
+
**Red Flag: "The implementer can figure out the context from the codebase"**
|
|
265
|
+
|
|
266
|
+
→ It cannot — not reliably. An implementer with no context will make assumptions, produce inconsistent code, or ask questions. Every omitted field is a gap the implementer will fill with a guess.
|
|
267
|
+
|
|
268
|
+
## Reporting Results
|
|
269
|
+
|
|
270
|
+
Every final response to the orchestrator MUST begin with `STATUS: DONE` or `STATUS: BLOCKED`.
|
|
271
|
+
|
|
272
|
+
```
|
|
273
|
+
STATUS: DONE
|
|
274
|
+
|
|
275
|
+
## Analysis
|
|
276
|
+
[structured JSON analysis object]
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
Use `STATUS: BLOCKED` only if the issue cannot be fetched (404) or the codebase cannot be accessed.
|
|
280
|
+
|
|
281
|
+
**IRON LAW: THE FIRST LINE OF YOUR FINAL RESPONSE IS ALWAYS "STATUS: DONE" OR "STATUS: BLOCKED". THE JSON ANALYSIS FOLLOWS AFTER.**
|
|
282
|
+
|
|
283
|
+
**Rules for JSON output:**
|
|
284
|
+
- `dependency_order` must be topologically sorted — tasks with no dependencies come first
|
|
285
|
+
- `task_id` format: `task-1`, `task-2`, ... (sequential)
|
|
286
|
+
- `dependencies` lists task_ids that must complete before this task
|
|
287
|
+
- All string arrays may be empty `[]` but not omitted
|
|
288
|
+
- `context` and `module_patterns` may be empty string if not applicable
|
|
289
|
+
- `requires_tests_creator` is always `true` — orchestrator must dispatch `tests-creator` before `task-implementer` for each task
|
|
290
|
+
- Output the JSON block as the **final message** to the orchestrator, preceded by a brief summary (issue type, number of tasks, overall complexity)
|
|
291
|
+
|
|
292
|
+
**Return format** (final message to orchestrator):
|
|
293
|
+
```
|
|
294
|
+
Analysis complete.
|
|
295
|
+
- Issue type: <type>
|
|
296
|
+
- Total tasks: <N>
|
|
297
|
+
- Overall complexity: <low|medium|high>
|
|
298
|
+
- Dependency order: task-1 → task-2 → task-3
|
|
299
|
+
|
|
300
|
+
<json block>
|
|
247
301
|
```
|
|
248
302
|
|
|
249
303
|
---
|
|
@@ -280,22 +334,34 @@ This skill is designed to run fully autonomously. The following settings control
|
|
|
280
334
|
1. **DO NOT** ask the user any questions. All input comes from the input contract.
|
|
281
335
|
2. **DO NOT** modify any files. This is a read-only analysis skill.
|
|
282
336
|
3. **DO NOT** make assumptions about implementation approach — describe WHAT, not HOW.
|
|
283
|
-
4. **DO** include enough context in each
|
|
337
|
+
4. **DO** include enough context in each task entry for a task-implementer to start without asking questions.
|
|
284
338
|
5. **DO** respect the 3-layer architecture: Service → Store → Component ordering.
|
|
285
339
|
6. **DO** identify existing tests and stories so implementer knows what to update.
|
|
286
340
|
7. **DO** note module patterns (how similar code is written nearby) for consistency.
|
|
287
|
-
8. Return the
|
|
341
|
+
8. Return the JSON analysis result as your **final message** to the orchestrator.
|
|
288
342
|
|
|
289
343
|
---
|
|
290
344
|
|
|
345
|
+
## Red Flags — Stop and re-read this skill if you are thinking:
|
|
346
|
+
|
|
347
|
+
| Rationalization | Why it's wrong |
|
|
348
|
+
|---|---|
|
|
349
|
+
| "The issue title is clear enough, I'll skip reading the full body" | Acceptance criteria, repro steps, and constraints live in the body — the title is just a label |
|
|
350
|
+
| "I know this codebase, I don't need to search for affected files" | Prior knowledge drifts; the search step catches files that have changed since you last looked |
|
|
351
|
+
| "I'll create one big task instead of decomposing — simpler to track" | A monolithic task cannot be parallelized or independently verified; it defeats the whole system |
|
|
352
|
+
| "The dependencies between tasks seem obvious, no need to map them" | Untracked dependencies cause agents to overwrite each other's work or build on stale code |
|
|
353
|
+
| "The issue body is mostly boilerplate, I've got the gist" | Edge cases and acceptance criteria are often buried in what looks like boilerplate |
|
|
354
|
+
|
|
355
|
+
**IRON LAW: ALWAYS READ THE FULL ISSUE BODY AND SEARCH THE CODEBASE BEFORE DECOMPOSING INTO TASKS.**
|
|
356
|
+
|
|
291
357
|
## Job Context Awareness
|
|
292
358
|
|
|
293
359
|
When dispatched by `job-orchestrator`, the prompt MAY include:
|
|
294
360
|
|
|
295
361
|
```
|
|
296
362
|
JOB_NAME: <job-name>
|
|
297
|
-
JOBS_ROOT:
|
|
298
|
-
CONTEXT_PATH:
|
|
363
|
+
JOBS_ROOT: <JOBS_ROOT>
|
|
364
|
+
CONTEXT_PATH: <JOBS_ROOT>/<job-name>/ai/context.md
|
|
299
365
|
```
|
|
300
366
|
|
|
301
367
|
If `CONTEXT_PATH` is provided and the file exists, read it during Phase 2 (ANALYZE) to:
|
|
@@ -135,7 +135,7 @@ DO NOT ask questions. DO NOT stop for user input. Run to completion.
|
|
|
135
135
|
```javascript
|
|
136
136
|
Task({
|
|
137
137
|
description: "Issue analysis: #4141",
|
|
138
|
-
subagent_type: "general",
|
|
138
|
+
subagent_type: "general-purpose",
|
|
139
139
|
prompt: "<generated prompt from template above>"
|
|
140
140
|
})
|
|
141
141
|
```
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: job-documenter
|
|
3
|
-
|
|
3
|
+
model_tier: light
|
|
4
|
+
description: "Use when a job folder needs to be initialized, or analysis/report/review documents need to be created or updated in jobs/."
|
|
4
5
|
triggers:
|
|
5
6
|
- "Document job"
|
|
6
7
|
- "Initialize job folder"
|
|
@@ -14,11 +15,19 @@ metadata:
|
|
|
14
15
|
license: "MIT"
|
|
15
16
|
---
|
|
16
17
|
|
|
18
|
+
<SUBAGENT-STOP>
|
|
19
|
+
If you were dispatched as a subagent to execute a specific task, skip this skill entirely.
|
|
20
|
+
This skill is for orchestrators and interactive session-level routing only.
|
|
21
|
+
Proceed directly with your assigned task.
|
|
22
|
+
</SUBAGENT-STOP>
|
|
23
|
+
|
|
17
24
|
# Job Documenter
|
|
18
25
|
|
|
26
|
+
> **JOBS_ROOT Note:** `JOBS_ROOT` is always passed explicitly by the orchestrator in the dispatch prompt. Never resolve it yourself — do not fall back to any hardcoded path.
|
|
27
|
+
|
|
19
28
|
## Purpose
|
|
20
29
|
|
|
21
|
-
Sub-agent responsible for creating and maintaining structured job documentation in
|
|
30
|
+
Sub-agent responsible for creating and maintaining structured job documentation in `<JOBS_ROOT>/`. Called exclusively by `job-orchestrator` to persist the lifecycle of orchestrated tasks — from initial plan through analysis, implementation, review, and final report.
|
|
22
31
|
|
|
23
32
|
**This skill is NOT invoked directly by users.** It is a service skill dispatched by the orchestrator.
|
|
24
33
|
|
|
@@ -43,7 +52,7 @@ The orchestrator provides a structured prompt with the following fields:
|
|
|
43
52
|
```
|
|
44
53
|
ACTION: init | add-document | update-readme | finalize
|
|
45
54
|
JOB_NAME: <kebab-case folder name>
|
|
46
|
-
JOBS_ROOT:
|
|
55
|
+
JOBS_ROOT: <JOBS_ROOT>
|
|
47
56
|
DATA: <action-specific payload — see below>
|
|
48
57
|
```
|
|
49
58
|
|
|
@@ -150,7 +159,7 @@ PLAN: <ordered list of planned steps>
|
|
|
150
159
|
DOCUMENTER_RESULT:
|
|
151
160
|
action: init
|
|
152
161
|
status: success | error
|
|
153
|
-
job_path:
|
|
162
|
+
job_path: <JOBS_ROOT>/<JOB_NAME>
|
|
154
163
|
files_created: [README.md, man/plan.md, ai/plan.md]
|
|
155
164
|
error_details: <if status is error>
|
|
156
165
|
```
|
|
@@ -299,7 +308,7 @@ SUMMARY: <1-3 sentence summary of what was accomplished>
|
|
|
299
308
|
DOCUMENTER_RESULT:
|
|
300
309
|
action: finalize
|
|
301
310
|
status: success | error
|
|
302
|
-
job_path:
|
|
311
|
+
job_path: <JOBS_ROOT>/<JOB_NAME>
|
|
303
312
|
final_status: <FINAL_STATUS>
|
|
304
313
|
total_documents: <count of all files in man/ + ai/>
|
|
305
314
|
verification: passed | <list of discrepancies>
|
|
@@ -341,7 +350,7 @@ Follow the rules from: rules/core/jobs-documentation.mdc
|
|
|
341
350
|
|
|
342
351
|
ACTION: <action>
|
|
343
352
|
JOB_NAME: <job-name>
|
|
344
|
-
JOBS_ROOT:
|
|
353
|
+
JOBS_ROOT: <JOBS_ROOT>
|
|
345
354
|
|
|
346
355
|
DATA:
|
|
347
356
|
<action-specific data>
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: job-documenter
|
|
3
|
-
|
|
3
|
+
model_tier: light
|
|
4
|
+
description: "Use when a job folder needs to be initialized, or analysis/report/review documents need to be created or updated in jobs/."
|
|
4
5
|
triggers:
|
|
5
6
|
- "Document job"
|
|
6
7
|
- "Initialize job folder"
|
|
@@ -14,11 +15,19 @@ metadata:
|
|
|
14
15
|
license: "MIT"
|
|
15
16
|
---
|
|
16
17
|
|
|
18
|
+
<SUBAGENT-STOP>
|
|
19
|
+
If you were dispatched as a subagent to execute a specific task, skip this skill entirely.
|
|
20
|
+
This skill is for orchestrators and interactive session-level routing only.
|
|
21
|
+
Proceed directly with your assigned task.
|
|
22
|
+
</SUBAGENT-STOP>
|
|
23
|
+
|
|
17
24
|
# Job Documenter
|
|
18
25
|
|
|
26
|
+
> **JOBS_ROOT Note:** `JOBS_ROOT` is always passed explicitly by the orchestrator in the dispatch prompt. Never resolve it yourself — do not fall back to any hardcoded path.
|
|
27
|
+
|
|
19
28
|
## Purpose
|
|
20
29
|
|
|
21
|
-
Sub-agent responsible for creating and maintaining structured job documentation in
|
|
30
|
+
Sub-agent responsible for creating and maintaining structured job documentation in `<JOBS_ROOT>/`. Called exclusively by `job-orchestrator` to persist the lifecycle of orchestrated tasks — from initial plan through analysis, implementation, review, and final report.
|
|
22
31
|
|
|
23
32
|
**This skill is NOT invoked directly by users.** It is a service skill dispatched by the orchestrator.
|
|
24
33
|
|
|
@@ -43,7 +52,7 @@ The orchestrator provides a structured prompt with the following fields:
|
|
|
43
52
|
```
|
|
44
53
|
ACTION: init | add-document | update-readme | finalize
|
|
45
54
|
JOB_NAME: <kebab-case folder name>
|
|
46
|
-
JOBS_ROOT:
|
|
55
|
+
JOBS_ROOT: <JOBS_ROOT>
|
|
47
56
|
DATA: <action-specific payload — see below>
|
|
48
57
|
```
|
|
49
58
|
|
|
@@ -150,7 +159,7 @@ PLAN: <ordered list of planned steps>
|
|
|
150
159
|
DOCUMENTER_RESULT:
|
|
151
160
|
action: init
|
|
152
161
|
status: success | error
|
|
153
|
-
job_path:
|
|
162
|
+
job_path: <JOBS_ROOT>/<JOB_NAME>
|
|
154
163
|
files_created: [README.md, man/plan.md, ai/plan.md]
|
|
155
164
|
error_details: <if status is error>
|
|
156
165
|
```
|
|
@@ -299,7 +308,7 @@ SUMMARY: <1-3 sentence summary of what was accomplished>
|
|
|
299
308
|
DOCUMENTER_RESULT:
|
|
300
309
|
action: finalize
|
|
301
310
|
status: success | error
|
|
302
|
-
job_path:
|
|
311
|
+
job_path: <JOBS_ROOT>/<JOB_NAME>
|
|
303
312
|
final_status: <FINAL_STATUS>
|
|
304
313
|
total_documents: <count of all files in man/ + ai/>
|
|
305
314
|
verification: passed | <list of discrepancies>
|
|
@@ -341,7 +350,7 @@ Follow the rules from: rules/core/jobs-documentation.mdc
|
|
|
341
350
|
|
|
342
351
|
ACTION: <action>
|
|
343
352
|
JOB_NAME: <job-name>
|
|
344
|
-
JOBS_ROOT:
|
|
353
|
+
JOBS_ROOT: <JOBS_ROOT>
|
|
345
354
|
|
|
346
355
|
DATA:
|
|
347
356
|
<action-specific data>
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: job-documenter
|
|
3
|
-
|
|
3
|
+
model_tier: light
|
|
4
|
+
description: "Use when a job folder needs to be initialized, or analysis/report/review documents need to be created or updated in jobs/."
|
|
4
5
|
triggers:
|
|
5
6
|
- "Document job"
|
|
6
7
|
- "Initialize job folder"
|
|
@@ -14,11 +15,19 @@ metadata:
|
|
|
14
15
|
license: "MIT"
|
|
15
16
|
---
|
|
16
17
|
|
|
18
|
+
<SUBAGENT-STOP>
|
|
19
|
+
If you were dispatched as a subagent to execute a specific task, skip this skill entirely.
|
|
20
|
+
This skill is for orchestrators and interactive session-level routing only.
|
|
21
|
+
Proceed directly with your assigned task.
|
|
22
|
+
</SUBAGENT-STOP>
|
|
23
|
+
|
|
17
24
|
# Job Documenter
|
|
18
25
|
|
|
26
|
+
> **JOBS_ROOT Note:** `JOBS_ROOT` is always passed explicitly by the orchestrator in the dispatch prompt. Never resolve it yourself — do not fall back to any hardcoded path.
|
|
27
|
+
|
|
19
28
|
## Purpose
|
|
20
29
|
|
|
21
|
-
Sub-agent responsible for creating and maintaining structured job documentation in
|
|
30
|
+
Sub-agent responsible for creating and maintaining structured job documentation in `<JOBS_ROOT>/`. Called exclusively by `job-orchestrator` to persist the lifecycle of orchestrated tasks — from initial plan through analysis, implementation, review, and final report.
|
|
22
31
|
|
|
23
32
|
**This skill is NOT invoked directly by users.** It is a service skill dispatched by the orchestrator.
|
|
24
33
|
|
|
@@ -43,7 +52,7 @@ The orchestrator provides a structured prompt with the following fields:
|
|
|
43
52
|
```
|
|
44
53
|
ACTION: init | add-document | update-readme | finalize
|
|
45
54
|
JOB_NAME: <kebab-case folder name>
|
|
46
|
-
JOBS_ROOT:
|
|
55
|
+
JOBS_ROOT: <JOBS_ROOT>
|
|
47
56
|
DATA: <action-specific payload — see below>
|
|
48
57
|
```
|
|
49
58
|
|
|
@@ -150,7 +159,7 @@ PLAN: <ordered list of planned steps>
|
|
|
150
159
|
DOCUMENTER_RESULT:
|
|
151
160
|
action: init
|
|
152
161
|
status: success | error
|
|
153
|
-
job_path:
|
|
162
|
+
job_path: <JOBS_ROOT>/<JOB_NAME>
|
|
154
163
|
files_created: [README.md, man/plan.md, ai/plan.md]
|
|
155
164
|
error_details: <if status is error>
|
|
156
165
|
```
|
|
@@ -299,7 +308,7 @@ SUMMARY: <1-3 sentence summary of what was accomplished>
|
|
|
299
308
|
DOCUMENTER_RESULT:
|
|
300
309
|
action: finalize
|
|
301
310
|
status: success | error
|
|
302
|
-
job_path:
|
|
311
|
+
job_path: <JOBS_ROOT>/<JOB_NAME>
|
|
303
312
|
final_status: <FINAL_STATUS>
|
|
304
313
|
total_documents: <count of all files in man/ + ai/>
|
|
305
314
|
verification: passed | <list of discrepancies>
|
|
@@ -341,7 +350,7 @@ Follow the rules from: rules/core/jobs-documentation.mdc
|
|
|
341
350
|
|
|
342
351
|
ACTION: <action>
|
|
343
352
|
JOB_NAME: <job-name>
|
|
344
|
-
JOBS_ROOT:
|
|
353
|
+
JOBS_ROOT: <JOBS_ROOT>
|
|
345
354
|
|
|
346
355
|
DATA:
|
|
347
356
|
<action-specific data>
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: job-documenter
|
|
3
|
-
|
|
3
|
+
model_tier: light
|
|
4
|
+
description: "Use when a job folder needs to be initialized, or analysis/report/review documents need to be created or updated in jobs/."
|
|
4
5
|
triggers:
|
|
5
6
|
- "Document job"
|
|
6
7
|
- "Initialize job folder"
|
|
@@ -14,11 +15,19 @@ metadata:
|
|
|
14
15
|
license: "MIT"
|
|
15
16
|
---
|
|
16
17
|
|
|
18
|
+
<SUBAGENT-STOP>
|
|
19
|
+
If you were dispatched as a subagent to execute a specific task, skip this skill entirely.
|
|
20
|
+
This skill is for orchestrators and interactive session-level routing only.
|
|
21
|
+
Proceed directly with your assigned task.
|
|
22
|
+
</SUBAGENT-STOP>
|
|
23
|
+
|
|
17
24
|
# Job Documenter
|
|
18
25
|
|
|
26
|
+
> **JOBS_ROOT Note:** `JOBS_ROOT` is always passed explicitly by the orchestrator in the dispatch prompt. Never resolve it yourself — do not fall back to any hardcoded path.
|
|
27
|
+
|
|
19
28
|
## Purpose
|
|
20
29
|
|
|
21
|
-
Sub-agent responsible for creating and maintaining structured job documentation in
|
|
30
|
+
Sub-agent responsible for creating and maintaining structured job documentation in `<JOBS_ROOT>/`. Called exclusively by `job-orchestrator` to persist the lifecycle of orchestrated tasks — from initial plan through analysis, implementation, review, and final report.
|
|
22
31
|
|
|
23
32
|
**This skill is NOT invoked directly by users.** It is a service skill dispatched by the orchestrator.
|
|
24
33
|
|
|
@@ -43,7 +52,7 @@ The orchestrator provides a structured prompt with the following fields:
|
|
|
43
52
|
```
|
|
44
53
|
ACTION: init | add-document | update-readme | finalize
|
|
45
54
|
JOB_NAME: <kebab-case folder name>
|
|
46
|
-
JOBS_ROOT:
|
|
55
|
+
JOBS_ROOT: <JOBS_ROOT>
|
|
47
56
|
DATA: <action-specific payload — see below>
|
|
48
57
|
```
|
|
49
58
|
|
|
@@ -150,7 +159,7 @@ PLAN: <ordered list of planned steps>
|
|
|
150
159
|
DOCUMENTER_RESULT:
|
|
151
160
|
action: init
|
|
152
161
|
status: success | error
|
|
153
|
-
job_path:
|
|
162
|
+
job_path: <JOBS_ROOT>/<JOB_NAME>
|
|
154
163
|
files_created: [README.md, man/plan.md, ai/plan.md]
|
|
155
164
|
error_details: <if status is error>
|
|
156
165
|
```
|
|
@@ -299,7 +308,7 @@ SUMMARY: <1-3 sentence summary of what was accomplished>
|
|
|
299
308
|
DOCUMENTER_RESULT:
|
|
300
309
|
action: finalize
|
|
301
310
|
status: success | error
|
|
302
|
-
job_path:
|
|
311
|
+
job_path: <JOBS_ROOT>/<JOB_NAME>
|
|
303
312
|
final_status: <FINAL_STATUS>
|
|
304
313
|
total_documents: <count of all files in man/ + ai/>
|
|
305
314
|
verification: passed | <list of discrepancies>
|
|
@@ -341,7 +350,7 @@ Follow the rules from: rules/core/jobs-documentation.mdc
|
|
|
341
350
|
|
|
342
351
|
ACTION: <action>
|
|
343
352
|
JOB_NAME: <job-name>
|
|
344
|
-
JOBS_ROOT:
|
|
353
|
+
JOBS_ROOT: <JOBS_ROOT>
|
|
345
354
|
|
|
346
355
|
DATA:
|
|
347
356
|
<action-specific data>
|
|
@@ -299,7 +299,7 @@ PLAN:
|
|
|
299
299
|
5. { id: "implement", type: "implement", agent: "task-implementer", depends: ["tests-creator"] }
|
|
300
300
|
6. { id: "sanity-check", type: "check", agent: "orchestrator", depends: ["implement"] }
|
|
301
301
|
7. { id: "verify", type: "verify", agent: "code-verifier", depends: ["sanity-check"] }
|
|
302
|
-
8. { id: "review", type: "review", agent: "
|
|
302
|
+
8. { id: "review", type: "review", agent: "review-orchestrator", depends: ["verify"] }
|
|
303
303
|
9. { id: "security", type: "security", agent: "security-audit", depends: ["implement"], conditional: true }
|
|
304
304
|
10. { id: "fix", type: "fix", agent: "task-implementer", depends: ["review"], conditional: true }
|
|
305
305
|
11. { id: "verify-post-fix", type: "verify", agent: "code-verifier", depends: ["fix"], conditional: true }
|
|
@@ -299,7 +299,7 @@ PLAN:
|
|
|
299
299
|
5. { id: "implement", type: "implement", agent: "task-implementer", depends: ["tests-creator"] }
|
|
300
300
|
6. { id: "sanity-check", type: "check", agent: "orchestrator", depends: ["implement"] }
|
|
301
301
|
7. { id: "verify", type: "verify", agent: "code-verifier", depends: ["sanity-check"] }
|
|
302
|
-
8. { id: "review", type: "review", agent: "
|
|
302
|
+
8. { id: "review", type: "review", agent: "review-orchestrator", depends: ["verify"] }
|
|
303
303
|
9. { id: "security", type: "security", agent: "security-audit", depends: ["implement"], conditional: true }
|
|
304
304
|
10. { id: "fix", type: "fix", agent: "task-implementer", depends: ["review"], conditional: true }
|
|
305
305
|
11. { id: "verify-post-fix", type: "verify", agent: "code-verifier", depends: ["fix"], conditional: true }
|
|
@@ -299,7 +299,7 @@ PLAN:
|
|
|
299
299
|
5. { id: "implement", type: "implement", agent: "task-implementer", depends: ["tests-creator"] }
|
|
300
300
|
6. { id: "sanity-check", type: "check", agent: "orchestrator", depends: ["implement"] }
|
|
301
301
|
7. { id: "verify", type: "verify", agent: "code-verifier", depends: ["sanity-check"] }
|
|
302
|
-
8. { id: "review", type: "review", agent: "
|
|
302
|
+
8. { id: "review", type: "review", agent: "review-orchestrator", depends: ["verify"] }
|
|
303
303
|
9. { id: "security", type: "security", agent: "security-audit", depends: ["implement"], conditional: true }
|
|
304
304
|
10. { id: "fix", type: "fix", agent: "task-implementer", depends: ["review"], conditional: true }
|
|
305
305
|
11. { id: "verify-post-fix", type: "verify", agent: "code-verifier", depends: ["fix"], conditional: true }
|
|
@@ -299,7 +299,7 @@ PLAN:
|
|
|
299
299
|
5. { id: "implement", type: "implement", agent: "task-implementer", depends: ["tests-creator"] }
|
|
300
300
|
6. { id: "sanity-check", type: "check", agent: "orchestrator", depends: ["implement"] }
|
|
301
301
|
7. { id: "verify", type: "verify", agent: "code-verifier", depends: ["sanity-check"] }
|
|
302
|
-
8. { id: "review", type: "review", agent: "
|
|
302
|
+
8. { id: "review", type: "review", agent: "review-orchestrator", depends: ["verify"] }
|
|
303
303
|
9. { id: "security", type: "security", agent: "security-audit", depends: ["implement"], conditional: true }
|
|
304
304
|
10. { id: "fix", type: "fix", agent: "task-implementer", depends: ["review"], conditional: true }
|
|
305
305
|
11. { id: "verify-post-fix", type: "verify", agent: "code-verifier", depends: ["fix"], conditional: true }
|
|
@@ -299,7 +299,7 @@ PLAN:
|
|
|
299
299
|
5. { id: "implement", type: "implement", agent: "task-implementer", depends: ["tests-creator"] }
|
|
300
300
|
6. { id: "sanity-check", type: "check", agent: "orchestrator", depends: ["implement"] }
|
|
301
301
|
7. { id: "verify", type: "verify", agent: "code-verifier", depends: ["sanity-check"] }
|
|
302
|
-
8. { id: "review", type: "review", agent: "
|
|
302
|
+
8. { id: "review", type: "review", agent: "review-orchestrator", depends: ["verify"] }
|
|
303
303
|
9. { id: "security", type: "security", agent: "security-audit", depends: ["implement"], conditional: true }
|
|
304
304
|
10. { id: "fix", type: "fix", agent: "task-implementer", depends: ["review"], conditional: true }
|
|
305
305
|
11. { id: "verify-post-fix", type: "verify", agent: "code-verifier", depends: ["fix"], conditional: true }
|