@fro.bot/systematic 1.23.2 → 1.23.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/agents/research/best-practices-researcher.md +2 -3
- package/agents/research/issue-intelligence-analyst.md +2 -3
- package/package.json +1 -1
- package/skills/ce-brainstorm/SKILL.md +10 -11
- package/skills/ce-compound/SKILL.md +11 -11
- package/skills/ce-compound-refresh/SKILL.md +2 -2
- package/skills/ce-ideate/SKILL.md +3 -4
- package/skills/ce-plan/SKILL.md +8 -8
- package/skills/ce-plan-beta/SKILL.md +9 -10
- package/skills/ce-review/SKILL.md +7 -7
- package/skills/ce-work/SKILL.md +4 -4
- package/skills/ce-work-beta/SKILL.md +556 -0
- package/skills/claude-permissions-optimizer/SKILL.md +161 -0
- package/skills/claude-permissions-optimizer/scripts/extract-commands.mjs +805 -0
- package/skills/deepen-plan/SKILL.md +15 -15
- package/skills/deepen-plan-beta/SKILL.md +3 -3
- package/skills/deploy-docs/SKILL.md +8 -8
- package/skills/file-todos/SKILL.md +2 -1
- package/skills/generate_command/SKILL.md +1 -1
- package/skills/{report-bug → report-bug-ce}/SKILL.md +38 -33
- package/skills/resolve-todo-parallel/SKILL.md +65 -0
- package/skills/setup/SKILL.md +3 -3
- package/skills/test-browser/SKILL.md +3 -4
- package/skills/create-agent-skill/SKILL.md +0 -10
- package/skills/create-agent-skills/SKILL.md +0 -265
- package/skills/create-agent-skills/references/api-security.md +0 -226
- package/skills/create-agent-skills/references/be-clear-and-direct.md +0 -531
- package/skills/create-agent-skills/references/best-practices.md +0 -404
- package/skills/create-agent-skills/references/common-patterns.md +0 -595
- package/skills/create-agent-skills/references/core-principles.md +0 -437
- package/skills/create-agent-skills/references/executable-code.md +0 -175
- package/skills/create-agent-skills/references/iteration-and-testing.md +0 -474
- package/skills/create-agent-skills/references/official-spec.md +0 -134
- package/skills/create-agent-skills/references/recommended-structure.md +0 -168
- package/skills/create-agent-skills/references/skill-structure.md +0 -152
- package/skills/create-agent-skills/references/using-scripts.md +0 -113
- package/skills/create-agent-skills/references/using-templates.md +0 -112
- package/skills/create-agent-skills/references/workflows-and-validation.md +0 -510
- package/skills/create-agent-skills/templates/router-skill.md +0 -73
- package/skills/create-agent-skills/templates/simple-skill.md +0 -33
- package/skills/create-agent-skills/workflows/add-reference.md +0 -96
- package/skills/create-agent-skills/workflows/add-script.md +0 -93
- package/skills/create-agent-skills/workflows/add-template.md +0 -74
- package/skills/create-agent-skills/workflows/add-workflow.md +0 -126
- package/skills/create-agent-skills/workflows/audit-skill.md +0 -138
- package/skills/create-agent-skills/workflows/create-domain-expertise-skill.md +0 -605
- package/skills/create-agent-skills/workflows/create-new-skill.md +0 -197
- package/skills/create-agent-skills/workflows/get-guidance.md +0 -121
- package/skills/create-agent-skills/workflows/upgrade-to-router.md +0 -161
- package/skills/create-agent-skills/workflows/verify-skill.md +0 -204
- package/skills/heal-skill/SKILL.md +0 -148
- package/skills/resolve_parallel/SKILL.md +0 -36
- package/skills/resolve_todo_parallel/SKILL.md +0 -38
|
@@ -32,8 +32,8 @@ Before going online, check if curated knowledge already exists in skills:
|
|
|
32
32
|
|
|
33
33
|
1. **Discover Available Skills**:
|
|
34
34
|
- Use the platform's native file-search/glob capability to find `SKILL.md` files in the active skill locations
|
|
35
|
-
- For maximum compatibility, check project/workspace skill directories in `.
|
|
36
|
-
- Also check user/home skill directories in `~/.
|
|
35
|
+
- For maximum compatibility, check project/workspace skill directories in `.opencode/skills/**/SKILL.md`, `.codex/skills/**/SKILL.md`, and `.agents/skills/**/SKILL.md`
|
|
36
|
+
- Also check user/home skill directories in `~/.config/opencode/skills/**/SKILL.md`, `~/.codex/skills/**/SKILL.md`, and `~/.agents/skills/**/SKILL.md`
|
|
37
37
|
- In Codex environments, `.agents/skills/` may be discovered from the current working directory upward to the repository root, not only from a single fixed repo root location
|
|
38
38
|
- If the current environment provides an `AGENTS.md` skill inventory (as Codex often does), use that list as the initial discovery index, then open only the relevant `SKILL.md` files
|
|
39
39
|
- Use the platform's native file-read capability to examine skill descriptions and understand what each covers
|
|
@@ -130,4 +130,3 @@ If you encounter conflicting advice, present the different viewpoints and explai
|
|
|
130
130
|
**Tool Selection:** Use native file-search/glob (e.g., `Glob`), content-search (e.g., `Grep`), and file-read (e.g., `Read`) tools for repository exploration. Only use shell for commands with no native equivalent (e.g., `bundle show`), one command at a time.
|
|
131
131
|
|
|
132
132
|
Your research should be thorough but focused on practical application. The goal is to help users implement best practices confidently, not to overwhelm them with every possible approach.
|
|
133
|
-
|
|
@@ -217,8 +217,8 @@ Every theme MUST include ALL of the following fields. Do not skip fields, merge
|
|
|
217
217
|
- **Always use `--jq` for field extraction and filtering** from `gh` JSON output (e.g., `gh issue list --json title --jq '.[].title'`, `gh issue list --json stateReason --jq '[.[] | select(.stateReason == "COMPLETED")]'`). The `gh` CLI has full jq support built in.
|
|
218
218
|
- **Never write inline scripts** (`python3 -c`, `node -e`, `ruby -e`) to process, filter, sort, or transform issue data. Reason over the data directly after reading it — you are an LLM, you can filter and cluster in context without running code.
|
|
219
219
|
- **Never pipe** `gh` output through any command (`| python3`, `| jq`, `| grep`, `| sort`). Use `--jq` flags instead, or read the output and reason over it.
|
|
220
|
-
- Use native file-search/glob tools (e.g., `Glob` in
|
|
221
|
-
- Use native content-search/grep tools (e.g., `Grep` in
|
|
220
|
+
- Use native file-search/glob tools (e.g., `Glob` in OpenCode) for any repo file exploration
|
|
221
|
+
- Use native content-search/grep tools (e.g., `Grep` in OpenCode) for searching file contents
|
|
222
222
|
- Do not use shell commands for tasks that have native tool equivalents (no `find`, `cat`, `rg` through shell)
|
|
223
223
|
|
|
224
224
|
## Integration Points
|
|
@@ -229,4 +229,3 @@ This agent is designed to be invoked by:
|
|
|
229
229
|
- Other skills or workflows — any context where understanding issue patterns is valuable
|
|
230
230
|
|
|
231
231
|
The output is self-contained and not coupled to any specific caller's context.
|
|
232
|
-
|
package/package.json
CHANGED
|
@@ -8,7 +8,7 @@ argument-hint: '[feature idea or problem to explore]'
|
|
|
8
8
|
|
|
9
9
|
**Note: The current year is 2026.** Use this when dating requirements documents.
|
|
10
10
|
|
|
11
|
-
Brainstorming helps answer **WHAT** to build through collaborative dialogue. It precedes `/
|
|
11
|
+
Brainstorming helps answer **WHAT** to build through collaborative dialogue. It precedes `/ce:plan`, which answers **HOW** to build it.
|
|
12
12
|
|
|
13
13
|
The durable output of this workflow is a **requirements document**. In other workflows this might be called a lightweight PRD or feature brief. In compound engineering, keep the workflow name `brainstorm`, but make the written artifact strong enough that planning does not need to invent product behavior, scope boundaries, or success criteria.
|
|
14
14
|
|
|
@@ -28,7 +28,7 @@ This skill does not implement code. It explores, clarifies, and documents decisi
|
|
|
28
28
|
1. **Ask one question at a time** - Do not batch several unrelated questions into one message.
|
|
29
29
|
2. **Prefer single-select multiple choice** - Use single-select when choosing one direction, one priority, or one next step.
|
|
30
30
|
3. **Use multi-select rarely and intentionally** - Use it only for compatible sets such as goals, constraints, non-goals, or success criteria that can all coexist. If prioritization matters, follow up by asking which selected item is primary.
|
|
31
|
-
4. **Use the platform's question tool when available** - When asking the user a question, prefer the platform's blocking question tool if one exists (`
|
|
31
|
+
4. **Use the platform's question tool when available** - When asking the user a question, prefer the platform's blocking question tool if one exists (`question` in OpenCode, `request_user_input` in Codex, `ask_user` in Gemini). Otherwise, present numbered options in chat and wait for the user's reply before proceeding.
|
|
32
32
|
|
|
33
33
|
## Output Guidance
|
|
34
34
|
|
|
@@ -83,7 +83,7 @@ Scan the repo before substantive brainstorming. Match depth to scope:
|
|
|
83
83
|
|
|
84
84
|
**Standard and Deep** — Two passes:
|
|
85
85
|
|
|
86
|
-
*Constraint Check* — Check project instruction files (`AGENTS.md
|
|
86
|
+
*Constraint Check* — Check project instruction files (`AGENTS.md`) for workflow, product, or scope constraints that affect the brainstorm. If these add nothing, move on.
|
|
87
87
|
|
|
88
88
|
*Topic Scan* — Search for relevant terms. Read the most relevant existing artifact if one exists (brainstorm, plan, spec, skill, feature doc). Skim adjacent examples covering similar behavior.
|
|
89
89
|
|
|
@@ -211,8 +211,8 @@ topic: <kebab-case-topic>
|
|
|
211
211
|
- [Affects R2][Needs research] [Question that likely requires research during planning]
|
|
212
212
|
|
|
213
213
|
## Next Steps
|
|
214
|
-
[If `Resolve Before Planning` is empty: `→ /
|
|
215
|
-
[If `Resolve Before Planning` is not empty: `→ Resume /
|
|
214
|
+
[If `Resolve Before Planning` is empty: `→ /ce:plan` for structured implementation planning]
|
|
215
|
+
[If `Resolve Before Planning` is not empty: `→ Resume /ce:brainstorm` to resolve blocking questions before planning]
|
|
216
216
|
```
|
|
217
217
|
|
|
218
218
|
For **Standard** and **Deep** brainstorms, a requirements document is usually warranted.
|
|
@@ -260,7 +260,7 @@ If `Resolve Before Planning` contains any items:
|
|
|
260
260
|
**Question when blocking questions remain and user wants to pause:** "Brainstorm paused. Planning is blocked until the remaining questions are resolved. What would you like to do next?"
|
|
261
261
|
|
|
262
262
|
Present only the options that apply:
|
|
263
|
-
- **Proceed to planning (Recommended)** - Run `/
|
|
263
|
+
- **Proceed to planning (Recommended)** - Run `/ce:plan` for structured implementation planning
|
|
264
264
|
- **Proceed directly to work** - Only offer this when scope is lightweight, success criteria are clear, scope boundaries are clear, and no meaningful technical or research questions remain
|
|
265
265
|
- **Review and refine** - Offer this only when a requirements document exists and can be improved through structured review
|
|
266
266
|
- **Ask more questions** - Continue clarifying scope, preferences, or edge cases
|
|
@@ -273,11 +273,11 @@ If the direct-to-work gate is not satisfied, omit that option entirely.
|
|
|
273
273
|
|
|
274
274
|
**If user selects "Proceed to planning (Recommended)":**
|
|
275
275
|
|
|
276
|
-
Immediately run `/
|
|
276
|
+
Immediately run `/ce:plan` in the current session. Pass the requirements document path when one exists; otherwise pass a concise summary of the finalized brainstorm decisions. Do not print the closing summary first.
|
|
277
277
|
|
|
278
278
|
**If user selects "Proceed directly to work":**
|
|
279
279
|
|
|
280
|
-
Immediately run `/
|
|
280
|
+
Immediately run `/ce:work` in the current session using the finalized brainstorm output as context. If a compact requirements document exists, pass its path. Do not print the closing summary first.
|
|
281
281
|
|
|
282
282
|
**If user selects "Share to Proof":**
|
|
283
283
|
|
|
@@ -317,7 +317,7 @@ Key decisions:
|
|
|
317
317
|
- [Decision 1]
|
|
318
318
|
- [Decision 2]
|
|
319
319
|
|
|
320
|
-
Recommended next step: `/
|
|
320
|
+
Recommended next step: `/ce:plan`
|
|
321
321
|
```
|
|
322
322
|
|
|
323
323
|
If the user pauses with `Resolve Before Planning` still populated, display:
|
|
@@ -331,6 +331,5 @@ Planning is blocked by:
|
|
|
331
331
|
- [Blocking question 1]
|
|
332
332
|
- [Blocking question 2]
|
|
333
333
|
|
|
334
|
-
Resume with `/
|
|
334
|
+
Resume with `/ce:brainstorm` when ready to resolve these before planning.
|
|
335
335
|
```
|
|
336
|
-
|
|
@@ -17,13 +17,13 @@ Captures problem solutions while context is fresh, creating structured documenta
|
|
|
17
17
|
## Usage
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
|
-
/
|
|
21
|
-
/
|
|
20
|
+
/ce:compound # Document the most recent fix
|
|
21
|
+
/ce:compound [brief context] # Provide additional context hint
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
## Execution Strategy
|
|
25
25
|
|
|
26
|
-
**Always run full mode by default.** Proceed directly to Phase 1 unless the user explicitly requests compact-safe mode (e.g., `/
|
|
26
|
+
**Always run full mode by default.** Proceed directly to Phase 1 unless the user explicitly requests compact-safe mode (e.g., `/ce:compound --compact` or "use compact mode").
|
|
27
27
|
|
|
28
28
|
Compact-safe mode exists as a lightweight alternative — see the **Compact-Safe Mode** section below. It's there if the user wants it, not something to push.
|
|
29
29
|
|
|
@@ -128,10 +128,10 @@ When invoking or recommending `ce:compound-refresh`, be explicit about the argum
|
|
|
128
128
|
|
|
129
129
|
Examples:
|
|
130
130
|
|
|
131
|
-
- `/
|
|
132
|
-
- `/
|
|
133
|
-
- `/
|
|
134
|
-
- `/
|
|
131
|
+
- `/ce:compound-refresh plugin-versioning-requirements`
|
|
132
|
+
- `/ce:compound-refresh payments`
|
|
133
|
+
- `/ce:compound-refresh performance-issues`
|
|
134
|
+
- `/ce:compound-refresh critical-patterns`
|
|
135
135
|
|
|
136
136
|
A single scope hint may still expand to multiple related docs when the change is cross-cutting within one domain, category, or pattern area.
|
|
137
137
|
|
|
@@ -299,7 +299,7 @@ Build → Test → Find Issue → Research → Improve → Document → Validate
|
|
|
299
299
|
|
|
300
300
|
<auto_invoke> <trigger_phrases> - "that worked" - "it's fixed" - "working now" - "problem solved" </trigger_phrases>
|
|
301
301
|
|
|
302
|
-
<manual_override> Use /
|
|
302
|
+
<manual_override> Use /ce:compound [context] to document immediately without waiting for auto-detection. </manual_override> </auto_invoke>
|
|
303
303
|
|
|
304
304
|
## Routes To
|
|
305
305
|
|
|
@@ -327,11 +327,11 @@ Based on problem type, these agents can enhance documentation:
|
|
|
327
327
|
|
|
328
328
|
### When to Invoke
|
|
329
329
|
- **Auto-triggered** (optional): Agents can run post-documentation for enhancement
|
|
330
|
-
- **Manual trigger**: User can invoke agents after /
|
|
331
|
-
- **Customize agents**: Edit `
|
|
330
|
+
- **Manual trigger**: User can invoke agents after /ce:compound completes for deeper review
|
|
331
|
+
- **Customize agents**: Edit `systematic.local.md` or invoke the `setup` skill to configure which review agents are used across all workflows
|
|
332
332
|
|
|
333
333
|
## Related Commands
|
|
334
334
|
|
|
335
335
|
- `/research [topic]` - Deep investigation (searches docs/solutions/ for patterns)
|
|
336
|
-
- `/
|
|
336
|
+
- `/ce:plan` - Planning workflow (references documented solutions)
|
|
337
337
|
|
|
@@ -33,7 +33,7 @@ Check if `$ARGUMENTS` contains `mode:autonomous`. If present, strip it from argu
|
|
|
33
33
|
|
|
34
34
|
Follow the same interaction style as `ce:brainstorm`:
|
|
35
35
|
|
|
36
|
-
- Ask questions **one at a time** — use the platform's blocking question tool when available (`
|
|
36
|
+
- Ask questions **one at a time** — use the platform's blocking question tool when available (`question` in OpenCode, `request_user_input` in Codex, `ask_user` in Gemini). Otherwise, present numbered options in plain text and wait for the user's reply before continuing
|
|
37
37
|
- Prefer **multiple choice** when natural options exist
|
|
38
38
|
- Start with **scope and intent**, then narrow only when needed
|
|
39
39
|
- Do **not** ask the user to make decisions before you have evidence
|
|
@@ -309,7 +309,7 @@ Do **not** ask questions about whether code changes were intentional, whether th
|
|
|
309
309
|
|
|
310
310
|
#### Question Style
|
|
311
311
|
|
|
312
|
-
Always present choices using the platform's blocking question tool when available (`
|
|
312
|
+
Always present choices using the platform's blocking question tool when available (`question` in OpenCode, `request_user_input` in Codex, `ask_user` in Gemini). Otherwise, present numbered options in plain text and wait for the user's reply before proceeding.
|
|
313
313
|
|
|
314
314
|
Question rules:
|
|
315
315
|
|
|
@@ -18,7 +18,7 @@ This workflow produces a ranked ideation artifact in `docs/ideation/`. It does *
|
|
|
18
18
|
|
|
19
19
|
## Interaction Method
|
|
20
20
|
|
|
21
|
-
Use the platform's blocking question tool when available (`
|
|
21
|
+
Use the platform's blocking question tool when available (`question` in OpenCode, `request_user_input` in Codex, `ask_user` in Gemini). Otherwise, present numbered options in chat and wait for the user's reply before proceeding.
|
|
22
22
|
|
|
23
23
|
Ask one question at a time. Prefer concise single-select choices when natural options exist.
|
|
24
24
|
|
|
@@ -29,7 +29,7 @@ Ask one question at a time. Prefer concise single-select choices when natural op
|
|
|
29
29
|
Interpret any provided argument as optional context. It may be:
|
|
30
30
|
|
|
31
31
|
- a concept such as `DX improvements`
|
|
32
|
-
- a path such as `plugins/
|
|
32
|
+
- a path such as `plugins/systematic/skills/`
|
|
33
33
|
- a constraint such as `low-complexity quick wins`
|
|
34
34
|
- a volume hint such as `top 3`, `100 ideas`, or `raise the bar`
|
|
35
35
|
|
|
@@ -103,7 +103,7 @@ Run agents in parallel in the **foreground** (do not use background dispatch —
|
|
|
103
103
|
|
|
104
104
|
1. **Quick context scan** — dispatch a general-purpose sub-agent with this prompt:
|
|
105
105
|
|
|
106
|
-
|
|
106
|
+
> Read the project's AGENTS.md (or README.md if AGENTS.md is absent), then discover the top-level directory layout using the native file-search/glob tool (e.g., `Glob` with pattern `*` or `*/*` in OpenCode). Return a concise summary (under 30 lines) covering:
|
|
107
107
|
> - project shape (language, framework, top-level directory layout)
|
|
108
108
|
> - notable patterns or conventions
|
|
109
109
|
> - obvious pain points or gaps
|
|
@@ -368,4 +368,3 @@ Before finishing, check:
|
|
|
368
368
|
- survivors are materially better than a naive "give me ideas" list
|
|
369
369
|
- the artifact was written before any handoff, sharing, or session end
|
|
370
370
|
- acting on an idea routes to `ce:brainstorm`, not directly to implementation
|
|
371
|
-
|
package/skills/ce-plan/SKILL.md
CHANGED
|
@@ -49,7 +49,7 @@ ls -la docs/brainstorms/*-requirements.md 2>/dev/null | head -10
|
|
|
49
49
|
5. Use source document content as the **primary input** to research and planning phases
|
|
50
50
|
6. **Critical: The source document is the origin document.** Throughout the plan, reference specific decisions with `(see origin: <source-path>)` when carrying forward conclusions. Do not paraphrase decisions in a way that loses their original context — link back to the source.
|
|
51
51
|
7. **Do not omit source content** — if the source document discussed it, the plan must address it (even if briefly). Scan each section before finalizing the plan to verify nothing was dropped.
|
|
52
|
-
8. **If `Resolve Before Planning` contains any items, stop.** Do not proceed with planning. Tell the user planning is blocked by unanswered brainstorm questions and direct them to resume `/
|
|
52
|
+
8. **If `Resolve Before Planning` contains any items, stop.** Do not proceed with planning. Tell the user planning is blocked by unanswered brainstorm questions and direct them to resume `/ce:brainstorm` or answer those questions first.
|
|
53
53
|
|
|
54
54
|
**If multiple source documents could match:**
|
|
55
55
|
Use **question tool** to ask which source document to use, or whether to proceed without one.
|
|
@@ -582,8 +582,8 @@ After writing the plan file, use the **question tool** to present these options:
|
|
|
582
582
|
2. **Run `/deepen-plan`** - Enhance each section with parallel research agents (best practices, performance, UI)
|
|
583
583
|
3. **Review and refine** - Improve the document through structured self-review
|
|
584
584
|
4. **Share to Proof** - Upload to Proof for collaborative review and sharing
|
|
585
|
-
5. **Start `/
|
|
586
|
-
6. **Start `/
|
|
585
|
+
5. **Start `/ce:work`** - Begin implementing this plan locally
|
|
586
|
+
6. **Start `/ce:work` on remote** - Begin implementing in OpenCode on the web (use `&` to run in background)
|
|
587
587
|
7. **Create Issue** - Create issue in project tracker (GitHub/Linear)
|
|
588
588
|
|
|
589
589
|
Based on selection:
|
|
@@ -600,14 +600,14 @@ Based on selection:
|
|
|
600
600
|
PROOF_URL=$(echo "$RESPONSE" | jq -r '.tokenUrl')
|
|
601
601
|
```
|
|
602
602
|
Display: `View & collaborate in Proof: <PROOF_URL>` — skip silently if curl fails. Then return to options.
|
|
603
|
-
- **`/
|
|
604
|
-
- **`/
|
|
603
|
+
- **`/ce:work`** → Call the /ce:work command with the plan file path
|
|
604
|
+
- **`/ce:work` on remote** → Run `/ce:work docs/plans/<plan_filename>.md &` to start work in background for OpenCode web
|
|
605
605
|
- **Create Issue** → See "Issue Creation" section below
|
|
606
606
|
- **Other** (automatically provided) → Accept free text for rework or specific changes
|
|
607
607
|
|
|
608
|
-
**Note:** If running `/
|
|
608
|
+
**Note:** If running `/ce:plan` with ultrathink enabled, automatically run `/deepen-plan` after plan creation for maximum depth and grounding.
|
|
609
609
|
|
|
610
|
-
Loop back to options after Simplify or Other changes until user selects `/
|
|
610
|
+
Loop back to options after Simplify or Other changes until user selects `/ce:work` or another action.
|
|
611
611
|
|
|
612
612
|
## Issue Creation
|
|
613
613
|
|
|
@@ -637,7 +637,7 @@ When user selects "Create Issue", detect their project tracker from AGENTS.md:
|
|
|
637
637
|
|
|
638
638
|
5. **After creation:**
|
|
639
639
|
- Display the issue URL
|
|
640
|
-
- Ask if they want to proceed to `/
|
|
640
|
+
- Ask if they want to proceed to `/ce:work`
|
|
641
641
|
|
|
642
642
|
NEVER CODE! Just research and write the plan.
|
|
643
643
|
|
|
@@ -15,7 +15,7 @@ This workflow produces a durable implementation plan. It does **not** implement
|
|
|
15
15
|
|
|
16
16
|
## Interaction Method
|
|
17
17
|
|
|
18
|
-
Use the platform's question tool when available. When asking the user a question, prefer the platform's blocking question tool if one exists (`
|
|
18
|
+
Use the platform's question tool when available. When asking the user a question, prefer the platform's blocking question tool if one exists (`question` in OpenCode, `request_user_input` in Codex, `ask_user` in Gemini). Otherwise, present numbered options in chat and wait for the user's reply before proceeding.
|
|
19
19
|
|
|
20
20
|
Ask one question at a time. Prefer a concise single-select choice when natural options exist.
|
|
21
21
|
|
|
@@ -150,7 +150,7 @@ Run these agents in parallel:
|
|
|
150
150
|
Collect:
|
|
151
151
|
- Existing patterns and conventions to follow
|
|
152
152
|
- Relevant files, modules, and tests
|
|
153
|
-
- AGENTS.md
|
|
153
|
+
- AGENTS.md guidance that materially affects the plan
|
|
154
154
|
- Institutional learnings from `docs/solutions/`
|
|
155
155
|
|
|
156
156
|
#### 1.2 Decide on External Research
|
|
@@ -518,8 +518,8 @@ After writing the plan file, present the options using the platform's blocking q
|
|
|
518
518
|
2. **Run `/deepen-plan-beta`** - Stress-test weak sections with targeted research when the plan needs more confidence
|
|
519
519
|
3. **Run `document-review` skill** - Improve the plan through structured document review
|
|
520
520
|
4. **Share to Proof** - Upload the plan for collaborative review and sharing
|
|
521
|
-
5. **Start `/
|
|
522
|
-
6. **Start `/
|
|
521
|
+
5. **Start `/ce:work`** - Begin implementing this plan in the current environment
|
|
522
|
+
6. **Start `/ce:work` in another session** - Begin implementing in a separate agent session when the current platform supports it
|
|
523
523
|
7. **Create Issue** - Create an issue in the configured tracker
|
|
524
524
|
|
|
525
525
|
Based on selection:
|
|
@@ -536,8 +536,8 @@ Based on selection:
|
|
|
536
536
|
PROOF_URL=$(echo "$RESPONSE" | jq -r '.tokenUrl')
|
|
537
537
|
```
|
|
538
538
|
Display `View & collaborate in Proof: <PROOF_URL>` if successful, then return to the options
|
|
539
|
-
- **`/
|
|
540
|
-
- **`/
|
|
539
|
+
- **`/ce:work`** → Call `/ce:work` with the plan path
|
|
540
|
+
- **`/ce:work` in another session** → If the current platform supports launching a separate agent session, start `/ce:work` with the plan path there. Otherwise, explain the limitation briefly and offer to run `/ce:work` in the current session instead.
|
|
541
541
|
- **Create Issue** → Follow the Issue Creation section below
|
|
542
542
|
- **Other** → Accept free text for revisions and loop back to options
|
|
543
543
|
|
|
@@ -545,7 +545,7 @@ If running with ultrathink enabled, or the platform's reasoning/effort level is
|
|
|
545
545
|
|
|
546
546
|
## Issue Creation
|
|
547
547
|
|
|
548
|
-
When the user selects "Create Issue", detect their project tracker from `
|
|
548
|
+
When the user selects "Create Issue", detect their project tracker from `AGENTS.md`:
|
|
549
549
|
|
|
550
550
|
1. Look for `project_tracker: github` or `project_tracker: linear`
|
|
551
551
|
2. If GitHub:
|
|
@@ -562,11 +562,10 @@ When the user selects "Create Issue", detect their project tracker from `CLAUDE.
|
|
|
562
562
|
|
|
563
563
|
4. If no tracker is configured:
|
|
564
564
|
- Ask which tracker they use using the platform's blocking question tool when available (see Interaction Method)
|
|
565
|
-
- Suggest adding the tracker to `
|
|
565
|
+
- Suggest adding the tracker to `AGENTS.md` for future runs
|
|
566
566
|
|
|
567
567
|
After issue creation:
|
|
568
568
|
- Display the issue URL
|
|
569
|
-
- Ask whether to proceed to `/
|
|
569
|
+
- Ask whether to proceed to `/ce:work`
|
|
570
570
|
|
|
571
571
|
NEVER CODE! Research, decide, and write the plan.
|
|
572
|
-
|
|
@@ -51,10 +51,10 @@ Ensure that the code is ready for analysis (either in worktree or on current bra
|
|
|
51
51
|
#### Protected Artifacts
|
|
52
52
|
|
|
53
53
|
<protected_artifacts>
|
|
54
|
-
The following paths are
|
|
54
|
+
The following paths are systematic pipeline artifacts and must never be flagged for deletion, removal, or gitignore by any review agent:
|
|
55
55
|
|
|
56
|
-
- `docs/brainstorms/*-requirements.md` — Requirements documents created by `/
|
|
57
|
-
- `docs/plans/*.md` — Plan files created by `/
|
|
56
|
+
- `docs/brainstorms/*-requirements.md` — Requirements documents created by `/ce:brainstorm`. These are the product-definition artifacts that planning depends on.
|
|
57
|
+
- `docs/plans/*.md` — Plan files created by `/ce:plan`. These are living documents that track implementation progress (checkboxes are checked off by `/ce:work`).
|
|
58
58
|
- `docs/solutions/*.md` — Solution documents created during the pipeline.
|
|
59
59
|
|
|
60
60
|
If a review agent flags any file in these directories for cleanup or removal, discard that finding during synthesis. Do not create a todo for it.
|
|
@@ -62,7 +62,7 @@ If a review agent flags any file in these directories for cleanup or removal, di
|
|
|
62
62
|
|
|
63
63
|
#### Load Review Agents
|
|
64
64
|
|
|
65
|
-
Read `
|
|
65
|
+
Read `systematic.local.md` in the project root. If found, use `review_agents` from YAML frontmatter. If the markdown body contains review context, pass it to each agent as additional instructions.
|
|
66
66
|
|
|
67
67
|
If no settings file exists, invoke the `setup` skill to create one. Then read the newly created file and continue.
|
|
68
68
|
|
|
@@ -279,9 +279,9 @@ Remove duplicates, prioritize by severity and impact.
|
|
|
279
279
|
|
|
280
280
|
```bash
|
|
281
281
|
# Launch multiple finding-creator agents in parallel
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
282
|
+
task() - Create todos for first finding
|
|
283
|
+
task() - Create todos for second finding
|
|
284
|
+
task() - Create todos for third finding
|
|
285
285
|
etc. for each finding.
|
|
286
286
|
```
|
|
287
287
|
|
package/skills/ce-work/SKILL.md
CHANGED
|
@@ -220,13 +220,13 @@ This command takes a work document (plan, specification, or todo file) and execu
|
|
|
220
220
|
# Run full test suite (use project's test command)
|
|
221
221
|
# Examples: bin/rails test, npm test, pytest, go test, etc.
|
|
222
222
|
|
|
223
|
-
# Run linting (per
|
|
223
|
+
# Run linting (per AGENTS.md)
|
|
224
224
|
# Use linting-agent before pushing to origin
|
|
225
225
|
```
|
|
226
226
|
|
|
227
227
|
2. **Consider Reviewer Agents** (Optional)
|
|
228
228
|
|
|
229
|
-
Use for complex, risky, or large changes. Read agents from `
|
|
229
|
+
Use for complex, risky, or large changes. Read agents from `systematic.local.md` frontmatter (`review_agents`). If no settings file, invoke the `setup` skill to create one.
|
|
230
230
|
|
|
231
231
|
Run configured agents in parallel with task tool. Present findings and address critical issues.
|
|
232
232
|
|
|
@@ -265,7 +265,7 @@ This command takes a work document (plan, specification, or todo file) and execu
|
|
|
265
265
|
|
|
266
266
|
Brief explanation if needed.
|
|
267
267
|
|
|
268
|
-
🤖 Generated with [MODEL] via [HARNESS](HARNESS_URL) +
|
|
268
|
+
🤖 Generated with [MODEL] via [HARNESS](HARNESS_URL) + Systematic v[VERSION]
|
|
269
269
|
|
|
270
270
|
Co-Authored-By: [MODEL] ([CONTEXT] context, [THINKING]) <noreply@anthropic.com>
|
|
271
271
|
EOF
|
|
@@ -360,7 +360,7 @@ This command takes a work document (plan, specification, or todo file) and execu
|
|
|
360
360
|
|
|
361
361
|
---
|
|
362
362
|
|
|
363
|
-
[![
|
|
363
|
+
[![Systematic v[VERSION]](https://img.shields.io/badge/Systematic-v[VERSION]-6366f1)](https://github.com/EveryInc/systematic)
|
|
364
364
|
🤖 Generated with [MODEL] ([CONTEXT] context, [THINKING]) via [HARNESS](HARNESS_URL)
|
|
365
365
|
EOF
|
|
366
366
|
)"
|