Skip to content

Organize spec and design documents into docs/superpowers#560

Open
aram356 wants to merge 3 commits intomainfrom
docs/organize-specs-and-archive
Open

Organize spec and design documents into docs/superpowers#560
aram356 wants to merge 3 commits intomainfrom
docs/organize-specs-and-archive

Conversation

@aram356
Copy link
Collaborator

@aram356 aram356 commented Mar 25, 2026

Summary

  • Create docs/superpowers/specs/ for active design documents and docs/superpowers/archive/ for historical ones
  • Move spec-like documents from project root and docs/internal/ into the new structure with timestamped filenames (YYYY-MM-DD-<topic>-design.md)
  • Enable superpowers and chrome-devtools plugins in .claude/settings.json
  • specs/: SSC PRD, SSC technical spec, EdgeZero migration, auction orchestration flow, production readiness report
  • archive/: optimization plan, sequence flow, publisher IDs audit

Closes #561

Test plan

  • Verify no broken internal links reference moved files
  • Confirm all moved files are intact at new locations
  • Confirm .claude/settings.json plugins load correctly

Move spec-like documents from root and docs/internal into a structured
layout under docs/superpowers with timestamped filenames:

- specs/: active design documents (SSC PRD, technical spec, EdgeZero
  migration, auction orchestration flow, production readiness report)
- archive/: completed or historical specs (optimization, sequence,
  publisher IDs audit)
@aram356 aram356 self-assigned this Mar 25, 2026
@aram356 aram356 linked an issue Mar 25, 2026 that may be closed by this pull request
Copy link
Collaborator

@prk-Jr prk-Jr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 Looks good. superpowers also create plans folder as well.

@aram356
Copy link
Collaborator Author

aram356 commented Mar 25, 2026

👍 Looks good. superpowers also create plans folder as well.

plans directory will be created when we have the first plan

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.

Update internal references to relocated spec documents

2 participants