Skip to content

ADR-336: Dev spec + proposal/detailed-design/dev-spec templates - #170

Draft
jodavis-claude wants to merge 2 commits into
feature/ADR-336-proposal-detailed-design-splitfrom
dev/claude/ADR-336-proposal-detailed-design-split
Draft

ADR-336: Dev spec + proposal/detailed-design/dev-spec templates#170
jodavis-claude wants to merge 2 commits into
feature/ADR-336-proposal-detailed-design-splitfrom
dev/claude/ADR-336-proposal-detailed-design-split

Conversation

@jodavis-claude

Copy link
Copy Markdown
Collaborator

Summary

  • Adds the dev spec for ADR-336 (Proposal / Detailed Design Split), which splits today's single design doc into a short Proposal (sells the problem/approach) and a Detailed Design (spells out desired behavior in full), leaving write-dev-spec and everything downstream unaffected.
  • Adds the three document templates the spec defines: proposal_template.md (write-design-spec first-draft), detailed_design_template.md (new detailed-design-first-draft skill), and dev_spec_template.md (write-dev-spec first-draft).

Test plan

  • Spec content reviewed for completeness against ADR-336
  • Templates reviewed for consistency with existing design/dev-spec doc conventions

🤖 Generated with Claude Code

https://claude.ai/code/session_0173ECh95RcYr18Pa1CnLT2z

Introduces the dev spec for the Proposal/Detailed Design split (ADR-336)
along with the new document templates it defines: a proposal template
for write-design-spec's first-draft skill, a detailed design template
for the new detailed-design-first-draft skill, and a dev spec template
for write-dev-spec's first-draft skill.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0173ECh95RcYr18Pa1CnLT2z
@github-actions

Copy link
Copy Markdown

build-and-test: Python test results

Status: ✅ Passed

Test log

Rewrite the Tasks section headings to the [ADR-XXX: Title](url) 🤖/🧑
form and Depends-on lines to reference real ADR-XXX keys instead of
local Task N numbers, so stack_registration.py can parse the stack
order for tasks in this epic.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ta9LkHviRw9DHfj54wRtam
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.

2 participants