import live www.sillylaird.ca webrootHEADmain

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.