first commit
This commit is contained in:
@@ -0,0 +1,30 @@
|
||||
# Document Type Scaffolds
|
||||
|
||||
## Decision doc
|
||||
- Context
|
||||
- Decision
|
||||
- Alternatives considered
|
||||
- Risks
|
||||
- Rollout / next steps
|
||||
|
||||
## Technical spec
|
||||
- Problem
|
||||
- Requirements
|
||||
- Proposed design
|
||||
- Data / API changes
|
||||
- Failure modes
|
||||
- Validation plan
|
||||
|
||||
## Proposal
|
||||
- Motivation
|
||||
- Proposed work
|
||||
- Expected impact
|
||||
- Risks and dependencies
|
||||
- Ask / timeline
|
||||
|
||||
## RFC
|
||||
- Background
|
||||
- Proposal
|
||||
- Open questions
|
||||
- Compatibility / migration
|
||||
- Decision record
|
||||
@@ -0,0 +1,16 @@
|
||||
# Reader Test
|
||||
|
||||
## Goal
|
||||
Use a fresh-reader pass to find blind spots, unclear assumptions, and missing context.
|
||||
|
||||
## Handoff package
|
||||
Provide the tester with:
|
||||
- document path,
|
||||
- intended audience,
|
||||
- expected action after reading,
|
||||
- any non-obvious constraints.
|
||||
|
||||
## Pass criteria
|
||||
- reader can explain the decision or proposal back accurately,
|
||||
- reader can identify next actions,
|
||||
- reader does not need hidden author context to follow the doc.
|
||||
@@ -0,0 +1,18 @@
|
||||
# Runtime Matrix
|
||||
|
||||
## Claude Code / local filesystem available
|
||||
- Prefer local markdown files.
|
||||
- Use direct file edits instead of artifact-only assumptions.
|
||||
- Use sub-agents for reader testing only when they are actually available.
|
||||
|
||||
## Claude.ai or app with artifacts
|
||||
- Use artifacts when they improve iteration speed.
|
||||
- Keep the document path or artifact identity explicit in the conversation.
|
||||
|
||||
## Connectors available
|
||||
- Pull context from connected systems only after user consent.
|
||||
- Summarize imported context before drafting.
|
||||
|
||||
## No connectors available
|
||||
- Ask the user to paste or summarize the needed context.
|
||||
- Do not imply that Slack / Drive / SharePoint can be read automatically.
|
||||
Reference in New Issue
Block a user