Skip to content

chore(docs): rationalize specs/plans layout with date prefixes (issue #36) - #37

Merged
bnaylor merged 1 commit into
mainfrom
chore/rationalize-specs-plans
Jul 28, 2026
Merged

chore(docs): rationalize specs/plans layout with date prefixes (issue #36)#37
bnaylor merged 1 commit into
mainfrom
chore/rationalize-specs-plans

Conversation

@clomp42

@clomp42 clomp42 commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Why This Change

Closes #36.

Standardizes design specs and implementation plans under and using ISO date prefixes ().

What Changed

  1. Date-Prefixed Renames (27 files):
    • Renamed all existing files in and using their original git creation dates (e.g., ).
    • Cleaned up underscores to hyphens for uniform slug naming across all plan and spec documents.
  2. Project & Agent Steering Rules:
    • Updated to explicitly enforce and as canonical paths and forbid saving specs/plans under .
    • Updated system prompt artifact instructions to specify date-prefixed formatting for and .

Testing

  • Verified preserves complete history for all renamed files.
  • Confirmed project instructions in and align across harnesses.

…36)

- Renamed all existing files in docs/plans/ and docs/specs/ to YYYY-MM-DD-feature-name.md based on git creation dates
- Updated AGENTS.md with explicit layout rules enforcing docs/specs/ and docs/plans/ date-prefixed conventions
- Updated SYSTEM.md system prompt instructions to reinforce docs/specs/ and docs/plans/ paths and disallow writing under superpowers/

Co-Authored-By: Clomp <clomp@scromp.net>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

rationalize specs/plans files

2 participants