mirror of
https://github.com/addyosmani/agent-skills.git
synced 2026-10-26 15:05:04 +00:00
docs: clarify spec and task file lifecycle
Fixes #39 Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
1 parent
8d79b5f93d
commit
a379b819de
1 file changed
+8
@@ -125,6 +125,14 @@ The `references/` directory contains supplementary checklists:
|
||||
|
||||
Load a reference when you need detailed patterns beyond what the skill covers.
|
||||
|
||||
## Spec and task artifacts
|
||||
|
||||
The `/spec` and `/plan` commands create working artifacts (`SPEC.md`, `tasks/plan.md`, `tasks/todo.md`). Treat them as **living documents** while the work is in progress:
|
||||
|
||||
- Keep them in version control during development so the human and the agent have a shared source of truth.
|
||||
- Update them when scope or decisions change.
|
||||
- If your repo doesn’t want these files long‑term, delete them before merge or add the folder to `.gitignore` — the workflow doesn’t require them to be permanent.
|
||||
|
||||
## Tips
|
||||
|
||||
1. **Start with spec-driven-development** for any non-trivial work
|
||||
|
||||
Reference in new issue
Block a user