Adopt standard docs/ spec structure (docs/specs + docs/designs), retire tasks/ convention#183
Merged
Merged
Conversation
…tion Replace the bespoke tasks/ durable-spec-archive convention with the industry-standard docs/ structure: - docs/specs/ -- PRDs / requirements (the *what*), written by @prd - docs/designs/ -- implementation plans (the *how*), written by @dev-loop/@plan - docs/README.md -- consumer-owned archive guide (same-name scaffold) Pull-SDLC.ai.ps1: TemplateScaffoldMap, UpstreamManagedPaths and AlwaysLocalPaths now carry docs/README.md, docs/specs/ and docs/designs/ instead of tasks/. Consolidate-Tasks.ps1 inverts direction -- it now consolidates legacy locations (tasks/*, docs/prd/*, root docs, sessions) INTO docs/specs/ and docs/designs/, writing docs/MIGRATION.md. The script filename is intentionally unchanged to avoid churning the meta-script lists. Agents (@prd, @plan, @Dev-Loop), README.md and .gitignore updated to the new paths. tasks/README.md moved to docs/README.md and rewritten. Closes #182
7360aba to
eeb9f48
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Replaces the bespoke
tasks/"durable spec archive" convention with theindustry-standard
docs/structure across the whole framework. The goal is adurable requirements corpus you could hand to a fresh AI to rebuild the app
from scratch --
docs/specs/(the what) +docs/designs/(the how) readsas the standard convention, whereas
tasks/reads as transient work items.Mapping
tasks/<issue#>-<slug>-prd.mddocs/specs/<issue#>-<slug>-prd.mdtasks/<issue#>-<slug>-plan.mddocs/designs/<issue#>-<slug>-plan.mdtasks/README.mddocs/README.md(consumer-owned, same-name scaffold)tasks/MIGRATION.mddocs/MIGRATION.mdChanges
Pull-SDLC.ai.ps1--TemplateScaffoldMap,UpstreamManagedPathsandAlwaysLocalPathsnow carrydocs/README.md,docs/specs/,docs/designs/.Carve-out comments updated.
Consolidate-Tasks.ps1-- inverted: consolidates legacy locations(
tasks/*,docs/prd/*, rootPRD.md/plan.md/IMPLEMENTATION_PLAN.md,copilot/claude sessions) into
docs/specs/anddocs/designs/; manifestat
docs/MIGRATION.md. Filename intentionally kept to avoid churning themeta-script lists.
@prd,@plan,@dev-loop),README.md,.gitignoreupdated to the new paths.
git mv tasks/README.md docs/README.md+ content rewrite; removedtasks/.gitkeepand the emptytasks/dir.Testing
Invoke-Pester Consolidate-Tasks.Tests.ps1-- 33 passed, 0 failedInvoke-Pester Pull-SDLC.ai.Tests.ps1-- 190 passed, 0 failedCloses #182