first commit

This commit is contained in:
2026-06-11 03:33:14 +08:00
commit 5f555bf342
599 changed files with 142347 additions and 0 deletions

View File

@@ -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

View File

@@ -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.

View File

@@ -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.