Skip to content

docs: let the aidd-dev skills alone decide a task folder's shape #1073

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
blafourcade merged 1 commit into from
Oct 21, 2026
+2 −3
Merged

docs: let the aidd-dev skills alone decide a task folder's shape #1073

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 2 additions & 3 deletions aidd_docs/memory/backlog.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
| AIDD Roadmap board (org project 8) | order, status, and what ships next | the single source of truth for the roadmap |
| Milestones | themes | one milestone per theme; no milestone means backlog |
| GitHub Discussions | ideas and their upvotes | where an idea is weighed before it becomes an issue |
| `aidd_docs/` task documents | the local contract, plan and evidence behind an issue | never a substitute for the issue |
| `aidd_docs/` task documents | the local plans, specs and reviews behind an issue | never a substitute for the issue |

## Representation

Expand Down Expand Up @@ -43,5 +43,4 @@ The board is moved by hand, by a human or an agent through `gh`. No workflow adv
## Relations

- An issue's branch and pull request carry the routing: the branch prefix decides the target, per `vcs.md`.
- A new `aidd_docs/` task folder holds `contract.md`, `plan.md` with its phases folded in, and `evidence.md`. The review lives in the pull request, not in a file, and no executable code or prototype goes in the folder: probes stay in the scratchpad. In this repository this overrides the `phase-<n>.md` that `aidd-dev:01-plan` writes and `aidd-dev:02-implement` reads, and the `review.md` that `aidd-dev:05-review` writes; folders made before this rule keep their files.
- A task folder is grouped by its parent document (`plan.md`, then `master-plan.md`, then `spec.md`), which goes to a Done status (`done` or `implemented`) when its pull request merges. A sub-document's status never moves that parent.
- A `aidd_docs/` task folder is grouped by its parent document (`plan.md`, then `master-plan.md`, then `spec.md`), and a sub-document's status never moves that parent.
Loading