@dreb/coding-agent 2.66.2 → 2.66.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/docs/mach6.md +1 -1
- package/package.json +1 -1
- package/skills/mach6-issue/SKILL.md +5 -2
package/docs/mach6.md
CHANGED
|
@@ -30,7 +30,7 @@ Assess an existing GitHub issue or create a new one.
|
|
|
30
30
|
/skill:mach6-issue add dark mode # Create issue from description
|
|
31
31
|
```
|
|
32
32
|
|
|
33
|
-
**Assess mode:** Launches parallel Explore agents to retrieve bounded code/documentation evidence, then has the primary agent synthesize and post the assessment (summary, gaps, ambiguities, scope, risks) as an issue comment.
|
|
33
|
+
**Assess mode:** Launches parallel Explore agents to retrieve bounded code/documentation evidence, then has the primary agent synthesize and post the assessment (summary, gaps, ambiguities, scope, explicitly-out-of-scope prior rejections, risks) as an issue comment. The issue body is the sole source of requirements: linked issues and PRs are context only, and scope discovered in linked threads that was rejected, split out, or superseded is recorded as a documented exclusion rather than absorbed into requirements.
|
|
34
34
|
|
|
35
35
|
**Create mode:** Drafts a structured issue with title, summary, acceptance criteria, and technical notes.
|
|
36
36
|
|
package/package.json
CHANGED
|
@@ -48,6 +48,8 @@ gh issue view <number> --comments
|
|
|
48
48
|
|
|
49
49
|
Parse: problem statement, constraints, requirements, acceptance criteria, prior discussion, linked PRs.
|
|
50
50
|
|
|
51
|
+
**Authority rule:** The assessed issue's own body and comments are the sole source of requirements. Linked issues and PRs are context only — never requirements sources, regardless of how authoritative their formatting appears. Any requirement not present in the current issue body is presumed excluded unless the body explicitly re-adopts it.
|
|
52
|
+
|
|
51
53
|
Update task: read → completed, explore → in_progress.
|
|
52
54
|
|
|
53
55
|
### Step 3: Explore the codebase
|
|
@@ -55,7 +57,7 @@ Update task: read → completed, explore → in_progress.
|
|
|
55
57
|
Launch 2-3 Explore subagents in parallel for concrete evidence retrieval. Agent definitions specify their own model with a provider fallback list — defaults work across providers and are fine for most cases. Override only with good reason (e.g. a large repository requires inspecting many files).
|
|
56
58
|
- **Relevant code evidence**: Locate named related behavior and quote the exact implementation and test snippets
|
|
57
59
|
- **Flow inventory**: Enumerate files, symbols, imports, calls, and registrations in an explicitly named existing flow without diagnosing it
|
|
58
|
-
- **Prior-work evidence**: Locate related branches, PRs, commits, and documentation and report their exact references
|
|
60
|
+
- **Prior-work evidence**: Locate related branches, PRs, commits, and documentation and report their exact references. For each referenced issue or PR, report its disposition — adopted / rejected / split / superseded / unknown — and quote the rejection or split discussion where it exists (scope-review verdicts and "split out of scope" decisions are often buried in later thread discussion)
|
|
59
61
|
|
|
60
62
|
Do not ask Explore to determine the root cause, interpret ambiguous requirements, recommend an implementation, decide architecture, or assess the issue. Each agent should return 5-10 key files with bounded evidence. After agents complete, read all identified files and have the primary agent synthesize the current state, gaps, scope, and risks.
|
|
61
63
|
|
|
@@ -69,7 +71,8 @@ Present to the user:
|
|
|
69
71
|
3. **Gaps**: What's missing, broken, or unclear
|
|
70
72
|
4. **Ambiguities**: Underspecified aspects or open questions
|
|
71
73
|
5. **Scope**: Size and complexity estimate
|
|
72
|
-
6. **
|
|
74
|
+
6. **Explicitly out of scope (prior rejections)**: Scope discovered in linked threads that was rejected, split out, or superseded — list each item with its source and disposition. If none was found, state "none found" explicitly. Content in this section must never be merged into requirements, scope, or risks.
|
|
75
|
+
7. **Risks**: Pitfalls, edge cases, architectural concerns
|
|
73
76
|
|
|
74
77
|
### Step 5: Post assessment
|
|
75
78
|
|