diff options
Diffstat (limited to '.agents/skills/doc-coauthoring/references')
3 files changed, 64 insertions, 0 deletions
diff --git a/.agents/skills/doc-coauthoring/references/DOC-TYPES.md b/.agents/skills/doc-coauthoring/references/DOC-TYPES.md new file mode 100644 index 0000000..eb163f3 --- /dev/null +++ b/.agents/skills/doc-coauthoring/references/DOC-TYPES.md @@ -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 diff --git a/.agents/skills/doc-coauthoring/references/READER-TEST.md b/.agents/skills/doc-coauthoring/references/READER-TEST.md new file mode 100644 index 0000000..2d80fa1 --- /dev/null +++ b/.agents/skills/doc-coauthoring/references/READER-TEST.md @@ -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. diff --git a/.agents/skills/doc-coauthoring/references/RUNTIME-MATRIX.md b/.agents/skills/doc-coauthoring/references/RUNTIME-MATRIX.md new file mode 100644 index 0000000..3a51dd2 --- /dev/null +++ b/.agents/skills/doc-coauthoring/references/RUNTIME-MATRIX.md @@ -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. |