docs: remove obsolete roadmap and planning docs
This commit is contained in:
@@ -6,36 +6,25 @@ This file applies to the entire repository.
|
||||
|
||||
## Read First
|
||||
|
||||
Before starting substantial work, read the roadmap that matches the task:
|
||||
Before starting substantial work, read the source-of-truth docs that match the task:
|
||||
|
||||
- implementation work: [docs/implementation-roadmap.md](/home/kurihada/project/ai-workflow-skill/docs/implementation-roadmap.md)
|
||||
- implementation and repository-structure work: [docs/architecture.md](/home/kurihada/project/ai-workflow-skill/docs/architecture.md), [docs/skill-workspace-monorepo.md](/home/kurihada/project/ai-workflow-skill/docs/skill-workspace-monorepo.md)
|
||||
- inbox Markdown test-plan work: [docs/tests/inbox/ROADMAP.md](/home/kurihada/project/ai-workflow-skill/docs/tests/inbox/ROADMAP.md)
|
||||
- execution-trace workflow: [docs/roadmaps/README.md](/home/kurihada/project/ai-workflow-skill/docs/roadmaps/README.md)
|
||||
|
||||
## Roadmap Update Rule
|
||||
## Documentation Update Rule
|
||||
|
||||
Updating the relevant roadmap is part of the definition of done.
|
||||
Updating the relevant source-of-truth documentation is part of the definition of done.
|
||||
|
||||
Do not finish a task and leave its roadmap stale.
|
||||
Do not finish a task and leave its documentation stale.
|
||||
|
||||
Required behavior:
|
||||
|
||||
- if you complete or materially change implementation progress, update [docs/implementation-roadmap.md](/home/kurihada/project/ai-workflow-skill/docs/implementation-roadmap.md) in the same change
|
||||
- if you complete or materially change implementation behavior, architecture, runtime ownership, or product structure, update the relevant source-of-truth docs in the same change
|
||||
- if you add, remove, or materially revise inbox Markdown test cases or test-plan documents, update [docs/tests/inbox/ROADMAP.md](/home/kurihada/project/ai-workflow-skill/docs/tests/inbox/ROADMAP.md) in the same change
|
||||
- when a test-plan document is created, update document progress
|
||||
- when a test case is written, update authored-case tracking and pending backlog
|
||||
- when a planned item is no longer needed, mark it as removed or deferred instead of silently dropping it
|
||||
|
||||
For substantial multi-step work, also keep an execution roadmap under [docs/roadmaps/active/](/home/kurihada/project/ai-workflow-skill/docs/roadmaps/active/) while the work is in progress, then move it to [docs/roadmaps/archive/](/home/kurihada/project/ai-workflow-skill/docs/roadmaps/archive/) when the work is complete.
|
||||
|
||||
Required behavior for execution roadmaps:
|
||||
|
||||
- before starting substantial multi-step work, create or adopt one roadmap file under [docs/roadmaps/active/](/home/kurihada/project/ai-workflow-skill/docs/roadmaps/active/)
|
||||
- write the intended task as checklist items and keep them updated as work progresses
|
||||
- if work is unfinished, blocked, or paused, leave the roadmap in `active/` with current status and next step
|
||||
- when all checklist items are complete, add a completion summary and move the file to `archive/` in the same change
|
||||
- use stable slug filenames and prefer one roadmap file per workstream rather than one file per tiny action
|
||||
|
||||
## Inbox Test-Plan Specific Rule
|
||||
|
||||
For `docs/tests/inbox/`:
|
||||
@@ -53,7 +42,7 @@ For `skills/`:
|
||||
- keep each skill self-contained around `SKILL.md`; add `agents/openai.yaml` and bundled assets only when they directly support real invocation
|
||||
- if a skill depends on an executable or other runtime asset, prefer bundling the required artifact with the skill instead of relying on ad hoc rebuild instructions as the primary workflow
|
||||
- when updating an existing skill, keep `SKILL.md`, `agents/openai.yaml`, and bundled assets consistent with each other
|
||||
- if you add or materially change a project skill, update [docs/implementation-roadmap.md](/home/kurihada/project/ai-workflow-skill/docs/implementation-roadmap.md) in the same change
|
||||
- if you add or materially change a project skill, update the relevant source-of-truth docs in the same change
|
||||
|
||||
## Frontend UI Reuse
|
||||
|
||||
|
||||
Reference in New Issue
Block a user