@dalzoubi/dev-agents-sync 2.0.4 → 2.0.6
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/README.md +32 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -79,6 +79,38 @@ Show lockfile status:
|
|
|
79
79
|
npx --yes @dalzoubi/dev-agents-sync@1 status
|
|
80
80
|
```
|
|
81
81
|
|
|
82
|
+
## Agents
|
|
83
|
+
|
|
84
|
+
Syncing installs six agents that form a spec-driven workflow:
|
|
85
|
+
**Define → Analyze → Implement / Test / Validate**, or **Supervise** to run the
|
|
86
|
+
loop autonomously. Each agent has a matching slash command (for example
|
|
87
|
+
`/define`), and every agent reads the project's `CLAUDE.md` / `AGENTS.md` at the
|
|
88
|
+
start of a session.
|
|
89
|
+
|
|
90
|
+
| Agent | Command | Purpose |
|
|
91
|
+
|---|---|---|
|
|
92
|
+
| `define` | `/define` | Planning agent for spec-driven development. Runs a one-question-at-a-time Q&A to turn a vague ask into a spec, then writes it to the project's spec directory. Read-only on source code; produces spec markdown only and auto-runs Analyze when done. |
|
|
93
|
+
| `analyze` | `/analyze` | Pre-implementation spec checker. Scans for unresolved `[NEEDS CLARIFICATION]` markers, checks structure and estimates, and emits a `PASS` or `BLOCKED` verdict. Read-only; reports only. |
|
|
94
|
+
| `implement` | `/implement` | Build-and-refactor agent. Builds features from an approved spec, refactors, debugs, and runs fix-build-test loops. The only agent that changes source files; pauses at checkpoints and won't commit unless asked. |
|
|
95
|
+
| `test` | `/test` | Test and quality agent. Writes unit/integration/regression tests, reproduces bugs with a failing test first, and adds edge cases. Edits **test files only** — never production code. |
|
|
96
|
+
| `validate` | `/validate` | Review and risk agent. Audits the current branch before a PR for security, regressions, accessibility, performance, spec conformance, and coverage gaps. Read-only; outputs a severity-ranked report. |
|
|
97
|
+
| `supervise` | `/supervise <spec-path> [--auto] [--verbose]` | Autonomous TDD orchestrator. Drives test → implement → validate across an approved spec's slices, one at a time, with per-slice cycle budgets and recurrence detection. Delegates to the other agents; pauses on recurring failures, budget exhaustion, or interrupt. |
|
|
98
|
+
|
|
99
|
+
A bonus command, `/preflight`, runs a pre-review checklist (lint, unit tests,
|
|
100
|
+
and build if relevant) and summarizes what changed. It does not push or open a PR.
|
|
101
|
+
|
|
102
|
+
### When to use which
|
|
103
|
+
|
|
104
|
+
| You want to… | Use |
|
|
105
|
+
|---|---|
|
|
106
|
+
| Scope a new feature or change before writing code | `/define` |
|
|
107
|
+
| Confirm a spec is ready to build from | `/analyze` |
|
|
108
|
+
| Build from an approved spec, refactor, or debug | `/implement` |
|
|
109
|
+
| Add test coverage or pin a bug with a failing test | `/test` |
|
|
110
|
+
| Audit risk right before opening a PR | `/validate` |
|
|
111
|
+
| Build an approved spec largely hands-off, slice by slice | `/supervise` |
|
|
112
|
+
| Run lint/tests/build before review | `/preflight` |
|
|
113
|
+
|
|
82
114
|
## Common Flags
|
|
83
115
|
|
|
84
116
|
- `--targets claude,cursor` selects output targets. Use `claude`, `cursor`, or both.
|
package/package.json
CHANGED