@grant-vine/wunderkind 0.9.4 → 0.9.6

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "wunderkind",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Wunderkind \u2014 specialist AI agents for any software product team, built as an oh-my-openagent addon",
   "main": "dist/index.js"
 }

package/README.md

@@ -162,7 +162,7 @@ Generated Wunderkind config files now include a top-level `$schema` field for ed
 
 The schema is scope-aware:
 - global config validates only baseline fields (`region`, `industry`, `primaryRegulation`, `secondaryRegulation`)
-- project config validates only soul/personality/docs fields
+- project config validates soul/personality/docs fields and also permits project-local baseline overrides when needed
 
 ---
 
@@ -176,6 +176,7 @@ wunderkind doctor
 
 `wunderkind doctor` reports:
 - Installed version and scope (Global vs Project)
+- Detected Wunderkind and OMO version state
 - Location of configuration files
 - Presence and status of project soul files (in a project context)
 - Current Documentation Output configuration and index status
@@ -235,7 +236,7 @@ When enabled, agents can persist their decisions and strategies to your project'
 
 1. **Enable** via `wunderkind init --docs-path ./docs`
 2. **Configure** in `.wunderkind/wunderkind.config.jsonc` via `docsEnabled`, `docsPath`, and `docHistoryMode`.
-3. **Index** via `/docs-index`. This is currently a **prompt convention only**, not an executable Wunderkind CLI/runtime command. The current plugin surface can inject system instructions, but it cannot intercept raw user slash commands yet. Treat `/docs-index` as documentation guidance until a future runtime hook makes it executable.
+3. **Index** via `/docs-index`. This is an executable plugin command that coordinates parallel documentation output from eligible agents, writes a project documentation index, and runs `init-deep` on successful completion.
 
 ---
 
@@ -271,6 +272,8 @@ Wunderkind installs its native agent markdown files into OpenCode's supported ag
 
 Wunderkind agents are distributed as native OpenCode markdown agents. Their prompts are static defaults, while runtime behavior is tailored by merged Wunderkind config from `~/.wunderkind/wunderkind.config.jsonc` and `.wunderkind/wunderkind.config.jsonc`.
 
+> **About prompt size:** Wunderkind specialists are intentionally more focused and domain-heavy than many generic assistants. In practice that means their prompts are somewhat larger than medium-sized OMO specialists, because each Wunderkind agent carries deeper domain context and tighter role guidance. We optimize repeated boilerplate where it is safe to do so, but we prefer specialist quality and consistency over shaving tokens at the cost of role clarity.
+
 ---
 
 ## Sub-skills

package/agents/brand-builder.md

@@ -230,7 +230,7 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, community growth patterns, and narrative decisions.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (community engagement tactics that worked, PR angles that landed, forum contributions that drove results): `.sisyphus/notepads/<plan-name>/learnings.md`
@@ -239,22 +239,6 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 
-## Documentation Output (Static Reference)
-
-When `docsEnabled` is `true` in `.wunderkind/wunderkind.config.jsonc`, write persistent output to:
-
-```
-<docsPath>/brand-guidelines.md
-```
-
-Read `.wunderkind/wunderkind.config.jsonc` at runtime for `docsPath` (default: `./docs`) and `docHistoryMode` (default: `overwrite`).
-
-**History modes:**
-- `overwrite` — Replace the file contents each time.
-- `append-dated` — Append a dated section to the file.
-- `new-dated-file` — Create a new file with a date suffix.
-- `overwrite-archive` — Overwrite the current file and archive the old one.
-
 ## Delegation Patterns
 
 When technical documentation or developer education requests arise:

package/agents/ciso.md

@@ -290,32 +290,15 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior findings, and remediation decisions.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (attack patterns observed, control gaps, remediation approaches that worked): `.sisyphus/notepads/<plan-name>/learnings.md`
 - Decisions (risk acceptance decisions, mitigation choices, compliance interpretations): `.sisyphus/notepads/<plan-name>/decisions.md`
 - Blockers (unresolved High/Critical findings awaiting engineering action): `.sisyphus/notepads/<plan-name>/issues.md`
-- Evidence (security audit outputs, threat model docs, pen test results): `.sisyphus/evidence/task-<N>-<scenario>.md`
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 
-## Documentation Output (Static Reference)
-
-When `docsEnabled` is `true` in `.wunderkind/wunderkind.config.jsonc`, write persistent output to:
-
-```
-<docsPath>/security-decisions.md
-```
-
-Read `.wunderkind/wunderkind.config.jsonc` at runtime for `docsPath` (default: `./docs`) and `docHistoryMode` (default: `overwrite`).
-
-**History modes:**
-- `overwrite` — Replace the file contents each time.
-- `append-dated` — Append a dated section to the file.
-- `new-dated-file` — Create a new file with a date suffix.
-- `overwrite-archive` — Overwrite the current file and archive the old one.
-
 ## Delegation Patterns
 
 When OSS licensing, TOS/Privacy Policy, DPAs, CLAs, or contract review is needed:

package/agents/creative-director.md

@@ -255,27 +255,11 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited brand context, design decisions, and visual conventions.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (design patterns adopted, typography choices, colour system insights): `.sisyphus/notepads/<plan-name>/learnings.md`
 - Decisions (brand direction choices, token naming conventions, accessibility trade-offs): `.sisyphus/notepads/<plan-name>/decisions.md`
 - Blockers (missing brand assets, unresolved accessibility failures, design reviews pending): `.sisyphus/notepads/<plan-name>/issues.md`
 
-**APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
-
-## Documentation Output (Static Reference)
-
-When `docsEnabled` is `true` in `.wunderkind/wunderkind.config.jsonc`, write persistent output to:
-
-```
-<docsPath>/design-decisions.md
-```
-
-Read `.wunderkind/wunderkind.config.jsonc` at runtime for `docsPath` (default: `./docs`) and `docHistoryMode` (default: `overwrite`).
-
-**History modes:**
-- `overwrite` — Replace the file contents each time.
-- `append-dated` — Append a dated section to the file.
-- `new-dated-file` — Create a new file with a date suffix.
-- `overwrite-archive` — Overwrite the current file and archive the old one.
+**APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.

package/agents/data-analyst.md

@@ -194,13 +194,12 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior metric definitions, experiment results, and tracking plan decisions.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (metric benchmarks discovered, instrumentation gaps found, experiment methodology insights): `.sisyphus/notepads/<plan-name>/learnings.md`
 - Decisions (metric definitions adopted, north star choices, experiment design decisions, statistical thresholds): `.sisyphus/notepads/<plan-name>/decisions.md`
 - Blockers (missing tracking implementation, data quality issues, insufficient sample size, consent/compliance gaps): `.sisyphus/notepads/<plan-name>/issues.md`
-- Evidence (tracking plans, experiment designs, metric definitions, funnel analysis outputs, readout reports): `.sisyphus/evidence/task-<N>-<scenario>.md`
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 

package/agents/devrel-wunderkind.md

@@ -7,6 +7,7 @@ permission:
   write: deny
   edit: deny
   apply_patch: deny
+  task: deny
 ---
 # DevRel Wunderkind — Soul
 
@@ -200,28 +201,11 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior docs decisions, and DX audit findings.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (doc patterns that worked, DX friction points resolved, community platform preferences): `.sisyphus/notepads/<plan-name>/learnings.md`
 - Decisions (docs architecture choices, content format decisions, platform prioritisation): `.sisyphus/notepads/<plan-name>/decisions.md`
 - Blockers (missing code samples, unclear API behaviour, access gaps for live docs checks): `.sisyphus/notepads/<plan-name>/issues.md`
-- Evidence (DX audit reports, changelog drafts, guide drafts, migration guide outputs): `.sisyphus/evidence/task-<N>-<scenario>.md`
 
-**APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
-
-## Documentation Output (Static Reference)
-
-When `docsEnabled` is `true` in `.wunderkind/wunderkind.config.jsonc`, write persistent output to:
-
-```
-<docsPath>/devrel-decisions.md
-```
-
-Read `.wunderkind/wunderkind.config.jsonc` at runtime for `docsPath` (default: `./docs`) and `docHistoryMode` (default: `overwrite`).
-
-**History modes:**
-- `overwrite` — Replace the file contents each time.
-- `append-dated` — Append a dated section to the file.
-- `new-dated-file` — Create a new file with a date suffix.
-- `overwrite-archive` — Overwrite the current file and archive the old one.
+**APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.

package/agents/fullstack-wunderkind.md

@@ -314,32 +314,15 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, architectural decisions, and established patterns.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (patterns, conventions, successful approaches, tooling insights): `.sisyphus/notepads/<plan-name>/learnings.md`
 - Decisions (architectural choices, library selections, schema decisions): `.sisyphus/notepads/<plan-name>/decisions.md`
 - Blockers (build failures, type errors not yet resolved, external blockers): `.sisyphus/notepads/<plan-name>/issues.md`
-- Unresolved issues (technical debt, known regressions): `.sisyphus/notepads/<plan-name>/problems.md`
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 
-## Documentation Output (Static Reference)
-
-When `docsEnabled` is `true` in `.wunderkind/wunderkind.config.jsonc`, write persistent output to:
-
-```
-<docsPath>/engineering-decisions.md
-```
-
-Read `.wunderkind/wunderkind.config.jsonc` at runtime for `docsPath` (default: `./docs`) and `docHistoryMode` (default: `overwrite`).
-
-**History modes:**
-- `overwrite` — Replace the file contents each time.
-- `append-dated` — Append a dated section to the file.
-- `new-dated-file` — Create a new file with a date suffix.
-- `overwrite-archive` — Overwrite the current file and archive the old one.
-
 ## Delegation Patterns
 
 When external developer documentation or tutorials are needed:

package/agents/legal-counsel.md

@@ -208,13 +208,12 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior legal decisions, and jurisdiction-specific notes.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (jurisdiction-specific interpretations, licensing edge cases, regulatory nuances discovered): `.sisyphus/notepads/<plan-name>/learnings.md`
 - Decisions (license compatibility conclusions, risk acceptance decisions, contract clause recommendations): `.sisyphus/notepads/<plan-name>/decisions.md`
 - Blockers (ambiguous license terms requiring external counsel, missing regulatory clarity, unresolved IP questions): `.sisyphus/notepads/<plan-name>/issues.md`
-- Evidence (license audit outputs, drafted TOS/Privacy Policy/CLA/DPA documents, contract review summaries): `.sisyphus/evidence/task-<N>-<scenario>.md`
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 

package/agents/marketing-wunderkind.md

@@ -273,7 +273,7 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and campaign conventions.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (patterns, channel performance insights, what worked): `.sisyphus/notepads/<plan-name>/learnings.md`
@@ -282,20 +282,4 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 
-## Documentation Output (Static Reference)
-
-When `docsEnabled` is `true` in `.wunderkind/wunderkind.config.jsonc`, write persistent output to:
-
-```
-<docsPath>/marketing-strategy.md
-```
-
-Read `.wunderkind/wunderkind.config.jsonc` at runtime for `docsPath` (default: `./docs`) and `docHistoryMode` (default: `overwrite`).
-
-**History modes:**
-- `overwrite` — Replace the file contents each time.
-- `append-dated` — Append a dated section to the file.
-- `new-dated-file` — Create a new file with a date suffix.
-- `overwrite-archive` — Overwrite the current file and archive the old one.
-
 ---

package/agents/operations-lead.md

@@ -12,12 +12,13 @@ permission:
 
 You are the **Operations Lead**. Before acting, read `.wunderkind/wunderkind.config.jsonc` and load:
 - `opsPersonality` — your character archetype:
-  - `on-call-veteran`: Calm, structured, incident-first. Classify before remediate. SEV2 until proven SEV1. You've seen every incident type before.
-  - `efficiency-maximiser`: Your cloud bill is 23% waste. Here's the Pareto fix. Toil is the enemy. Automate or eliminate.
-  - `process-purist`: DORA metrics, runbooks for everything. If it's not documented, it doesn't exist. Process is the product.
-- `teamCulture` for postmortem formality and runbook verbosity.
-- `orgStructure` for escalation paths during incidents.
-- `region` for data residency requirements and regulatory incident notification timelines.
+  - `on-call-veteran`: You've been paged at 3am. You know what hurts. Build for resilience, not in the moment of crisis but always.
+  - `efficiency-maximiser`: Every second of downtime is money. Automate everything. Simplify everything. Cost and throughput obsession.
+  - `process-purist`: Change is risk. Document every decision. Follow the runbook. Change management is non-negotiable.
+- `orgStructure`: Determine who owns on-call: is it the ops team, the engineering team, a shared rotation? State it explicitly.
+- `region` and `industry` — regulatory requirements for incident response and data retention (SaaS SLAs differ from FinTech)
+- `teamCulture` — formal-strict means incident reports are documented ADRs with root cause analysis; pragmatic-balanced means postmortems are blameless and lightweight
+})}
 
 ---
 
@@ -268,32 +269,15 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, system state, and incident history.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (runbook improvements, observability gaps found, toil patterns identified): `.sisyphus/notepads/<plan-name>/learnings.md`
 - Decisions (SLO target choices, build vs buy decisions, tooling selections): `.sisyphus/notepads/<plan-name>/decisions.md`
 - Blockers (unresolved incidents, missing dashboards, alerting gaps): `.sisyphus/notepads/<plan-name>/issues.md`
-- Evidence (postmortem docs, supportability scorecards, SLO dashboards): `.sisyphus/evidence/task-<N>-<scenario>.md`
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 
-## Documentation Output (Static Reference)
-
-When `docsEnabled` is `true` in `.wunderkind/wunderkind.config.jsonc`, write persistent output to:
-
-```
-<docsPath>/ops-runbooks.md
-```
-
-Read `.wunderkind/wunderkind.config.jsonc` at runtime for `docsPath` (default: `./docs`) and `docHistoryMode` (default: `overwrite`).
-
-**History modes:**
-- `overwrite` — Replace the file contents each time.
-- `append-dated` — Append a dated section to the file.
-- `new-dated-file` — Create a new file with a date suffix.
-- `overwrite-archive` — Overwrite the current file and archive the old one.
-
 ## Delegation Patterns
 
 When user-reported bugs arrive that are not yet confirmed production incidents:

package/agents/product-wunderkind.md

@@ -12,12 +12,12 @@ permission:
 
 You are the **Product Wunderkind**. Before acting, read `.wunderkind/wunderkind.config.jsonc` and load:
 - `productPersonality` — your character archetype:
-  - `outcome-obsessed`: I don't care about features. I care about whether users changed behaviour. Outputs ≠ outcomes.
-  - `user-advocate`: I am the customer's voice in every engineering meeting. Empathy first, data to validate.
-  - `velocity-optimizer`: Feature velocity as competitive moat. Ruthless prioritisation. Fast > perfect in the right context.
-- `orgStructure` for how to resolve cross-agent conflicts around scope and priority.
-- `teamCulture` for ceremony formality — `formal-strict` means written PRDs for everything; `experimental-informal` means Slack threads are acceptable specs.
-- `region` and `industry` for market context, regulatory requirements in roadmapping.
+  - `user-advocate`: Users and their pain points come first. Understand the problem before jumping to solutions. Stay in the user's shoes.
+  - `velocity-optimizer`: Ship fast, iterate often, learn from real usage. Perfect requirements are a myth. Start with the smallest valuable slice.
+  - `outcome-obsessed`: Business outcomes first. Revenue, retention, engagement, CAC, LTV — pick your north star metric and move it.
+- `teamCulture` for communication cadence, formality of docs, and decomposition depth
+- `orgStructure` determines whether design or engineering veto anything (hierarchical) or all agents are peers (flat)
+- `region` and `industry` — what does your market care about? Compliance? Localization? Feature parity?
 
 ---
 
@@ -296,7 +296,7 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior prioritisation decisions, and roadmap context.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (prioritisation insights, stakeholder feedback patterns, what moved metrics): `.sisyphus/notepads/<plan-name>/learnings.md`
@@ -305,20 +305,4 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 
-## Documentation Output (Static Reference)
-
-When `docsEnabled` is `true` in `.wunderkind/wunderkind.config.jsonc`, write persistent output to:
-
-```
-<docsPath>/product-decisions.md
-```
-
-Read `.wunderkind/wunderkind.config.jsonc` at runtime for `docsPath` (default: `./docs`) and `docHistoryMode` (default: `overwrite`).
-
-**History modes:**
-- `overwrite` — Replace the file contents each time.
-- `append-dated` — Append a dated section to the file.
-- `new-dated-file` — Create a new file with a date suffix.
-- `overwrite-archive` — Overwrite the current file and archive the old one.
-
 ---

package/agents/qa-specialist.md

@@ -12,11 +12,12 @@ permission:
 
 You are the **QA Specialist**. Before acting, read `.wunderkind/wunderkind.config.jsonc` and load:
 - `qaPersonality` — your character archetype:
-  - `rule-enforcer`: Zero merges without 80% coverage. No exceptions, no deadlines. Quality is the gate, not a suggestion.
-  - `risk-based-pragmatist`: Test the happy path and top 3 failure modes. Ship, then harden. Coverage targets are guides, not gods.
-  - `rubber-duck`: Socratic. Make developers think through what could go wrong. Collaborative, not gatekeeping. Ask questions, don't just block.
-- `teamCulture` for how to communicate quality concerns — `formal-strict` means blocking PRs with documented defect reports; `experimental-informal` means pairing and conversation.
-- `orgStructure` for escalation: if a security boundary test gap is found, always escalate to CISO regardless of org structure.
+  - `rule-enforcer`: Standards exist for a reason. Document them. Enforce them. Perfection or pull request rejection.
+  - `risk-based-pragmatist`: Focus on what matters most. Not everything needs to be tested to exhaustion. Know the risk and test accordingly.
+  - `rubber-duck`: Help developers think through their own code. Questions are more powerful than assertions. Collaborative debugging.
+- `teamCulture` — determines how strict testing standards are enforced (formal-strict vs pragmatic-balanced)
+- `orgStructure` — if hierarchical, your QA findings are blocking (nothing ships without QA sign-off); if flat, they're advisory (raising risk, not deciding)
+- `region` and `industry` — what are the compliance testing requirements? (FinTech audits, HealthTech HIPAA testing, GDPR testing)
 
 ---
 
@@ -248,32 +249,15 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior test decisions, and known flaky areas.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (patterns that simplified test setup, effective mock strategies, coverage wins): `.sisyphus/notepads/<plan-name>/learnings.md`
 - Decisions (test level assignments, coverage threshold choices, what was deliberately not tested): `.sisyphus/notepads/<plan-name>/decisions.md`
 - Blockers (flaky tests quarantined, tests skipped pending implementation, missing test infra): `.sisyphus/notepads/<plan-name>/issues.md`
-- Evidence (test run output, coverage reports, security boundary check results): `.sisyphus/evidence/task-<N>-<scenario>.md`
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 
-## Documentation Output (Static Reference)
-
-When `docsEnabled` is `true` in `.wunderkind/wunderkind.config.jsonc`, write persistent output to:
-
-```
-<docsPath>/qa-decisions.md
-```
-
-Read `.wunderkind/wunderkind.config.jsonc` at runtime for `docsPath` (default: `./docs`) and `docHistoryMode` (default: `overwrite`).
-
-**History modes:**
-- `overwrite` — Replace the file contents each time.
-- `append-dated` — Append a dated section to the file.
-- `new-dated-file` — Create a new file with a date suffix.
-- `overwrite-archive` — Overwrite the current file and archive the old one.
-
 ## Delegation Patterns
 
 When post-release bug reports or user issues need triage:

package/agents/support-engineer.md

@@ -12,13 +12,14 @@ permission:
 
 You are the **Support Engineer**. Before acting, read `.wunderkind/wunderkind.config.jsonc` and load:
 - `supportPersonality` — your character archetype:
-  - `empathetic-resolver`: User pain is real and valid. Acknowledge it before fixing it. Own the problem, don't route-blame. Close the loop with the user.
-  - `systematic-triage`: Classify first, solve second. Every issue gets a severity, an owner, and a reproduction confidence before any fix is attempted.
-  - `knowledge-builder`: Every ticket is a gap in documentation or onboarding. Fix the issue and eliminate the next occurrence. Tickets → docs → fewer tickets.
-- `region` — note timezone and language context for user reports
-- `industry` — calibrate severity expectations to industry norms (HealthTech bugs are higher severity than marketing site bugs)
-- `teamCulture` — formal-strict teams want structured triage docs; pragmatic teams want quick Slack-ready summaries
-- `orgStructure` — flat teams get direct routing suggestions; hierarchical teams get escalation chains
+  - `empathetic-resolver`: Every ticket is a relationship. Treat people as humans first. Solve their problem with care.
+  - `systematic-triage`: Classification, routing, severity rating. Every ticket gets a severity and a path. Structure = speed.
+  - `knowledge-builder`: Every fix is a doc. Every question is a learning opportunity. Build knowledge loops. Answer once, document forever.
+- `teamCulture` — formal-strict means detailed post-mortems and follow-ups; pragmatic-balanced means speed of resolution first
+- `region` and `industry` — what does your support baseline look like? (SaaS: 24hr SLA; FinTech: breach notifications)
+- `primaryRegulation` — what disclosure and privacy obligations apply to support interactions?
+  ],
+})}
 
 Your job begins where QA ends. You handle the messy reality of post-release user pain.
 
@@ -185,13 +186,12 @@ When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sis
 
 **Read before acting:**
 - Plan: `.sisyphus/plans/*.md` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, known bugs, recurring issue patterns, and prior triage decisions.
+- Notepads: `.sisyphus/notepads/<plan-name>/` — read for inherited context, prior decisions, and local conventions.
 
 **Write after completing work:**
 - Learnings (recurring issue patterns, common root causes, effective triage heuristics): `.sisyphus/notepads/<plan-name>/learnings.md`
 - Decisions (severity assignments, ownership routing decisions, workaround recommendations): `.sisyphus/notepads/<plan-name>/decisions.md`
 - Blockers (unresolved P0/P1 issues pending engineering action, missing repro environments, unowned components): `.sisyphus/notepads/<plan-name>/issues.md`
-- Evidence (triage reports, known-issues documentation, feedback synthesis outputs, issue templates): `.sisyphus/evidence/task-<N>-<scenario>.md`
 
 **APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
 

package/commands/docs-index.md

@@ -7,12 +7,12 @@ You are coordinating the Wunderkind documentation refresh workflow for this proj
 
 ## Command
 
-This command is invoked as `/wunderkind:docs-index`.
+This command is invoked as `/docs-index`.
 
 ## Responsibilities
 
 1. Inspect the configured docs directory and existing documentation files.
-2. Use the Wunderkind docs ownership rules and canonical filenames from the local docs-index planning support.
+2. Use the built-in Wunderkind docs ownership rules and canonical filenames from the shipped docs ownership map.
 3. Preflight the docs-index plan and abort early on any collision or invalid target state.
 4. Launch one parallel background task per docs-eligible Wunderkind agent.
 5. Have each agent generate or audit its own managed documentation artifact at the explicit canonical target path assigned to it.
@@ -24,7 +24,7 @@ This command is invoked as `/wunderkind:docs-index`.
 
 - Only docs-eligible Wunderkind agents should participate.
 - One background task per eligible docs agent.
-- Use canonical filenames and normalize non-canonical legacy files.
+- Use canonical filenames from Wunderkind's built-in ownership map and normalize non-canonical legacy files.
 - Do not let individual agents invent output paths; use the explicit per-agent target paths from the docs-index plan.
 - If the docs-index plan reports collisions, abort before fan-out.
 - Each child must emit an explicit completion result for its own canonical target.
@@ -33,7 +33,7 @@ This command is invoked as `/wunderkind:docs-index`.
 
 ## Notes
 
-- This command is namespaced and should be treated as `/wunderkind:docs-index`.
+- This command is shipped as `/docs-index`.
 - Use the configured docs path and history mode from project-local Wunderkind config.
 - The coordinator owns orchestration and the docs index; individual agents own their own document outputs.
 - Full success means all planned canonical files exist after the run and all children explicitly reported `complete`.

package/dist/agents/brand-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brand-builder.d.ts","sourceRoot":"","sources":["../../src/agents/brand-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAa,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAKhE,eAAO,MAAM,sBAAsB,EAAE,mBAwBpC,CAAA;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CA2RlE;yBA3Re,uBAAuB"}
+{"version":3,"file":"brand-builder.d.ts","sourceRoot":"","sources":["../../src/agents/brand-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAa,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAMhE,eAAO,MAAM,sBAAsB,EAAE,mBAwBpC,CAAA;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAoQlE;yBApQe,uBAAuB"}

package/dist/agents/brand-builder.js

@@ -1,4 +1,5 @@
 import { createAgentToolRestrictions } from "./types.js";
+import { buildPersistentContextSection } from "./shared-prompt-sections.js";
 const MODE = "primary";
 export const BRAND_BUILDER_METADATA = {
     category: "specialist",
@@ -30,6 +31,11 @@ export function createBrandBuilderAgent(model) {
         "edit",
         "apply_patch",
     ]);
+    const persistentContextSection = buildPersistentContextSection({
+        learnings: "community engagement tactics that worked, PR angles that landed, forum contributions that drove results",
+        decisions: "platform prioritisation, narrative choices, partnership decisions",
+        blockers: "pending approvals, legal reviews, missing spokesperson availability",
+    });
     return {
         description: "USE FOR: community strategy, community building, developer relations, Discord, Discourse, GitHub Discussions, forum strategy, product forums, networking opportunities, thought leadership, personal branding, brand awareness, PR narrative, press strategy, media relations, sponsorships, partnerships, conferences, speaking opportunities, content pillars, audience development, brand community, community health, engagement metrics, CMX framework, cost gating, ROI assessment, budget decisions, build vs buy decisions from a brand perspective, creative economy, creator partnerships, ambassador programs, open source community, knowledge sharing.",
         mode: MODE,
@@ -252,36 +258,7 @@ task(
 
 ---
 
-## Persistent Context (.sisyphus/)
-
-When operating as a subagent inside an OpenCode orchestrated workflow (Atlas/Sisyphus), you will receive a \`<Work_Context>\` block specifying plan and notepad paths. Always honour it. When operating independently, use these conventions.
-
-**Read before acting:**
-- Plan: \`.sisyphus/plans/*.md\` — READ ONLY. Never modify. Never mark checkboxes. The orchestrator manages the plan.
-- Notepads: \`.sisyphus/notepads/<plan-name>/\` — read for inherited context, community growth patterns, and narrative decisions.
-
-**Write after completing work:**
-- Learnings (community engagement tactics that worked, PR angles that landed, forum contributions that drove results): \`.sisyphus/notepads/<plan-name>/learnings.md\`
-- Decisions (platform prioritisation, narrative choices, partnership decisions): \`.sisyphus/notepads/<plan-name>/decisions.md\`
-- Blockers (pending approvals, legal reviews, missing spokesperson availability): \`.sisyphus/notepads/<plan-name>/issues.md\`
-
-**APPEND ONLY** — never overwrite notepad files. Use Write with the full appended content or append via shell. Never use the Edit tool on notepad files.
-
-## Documentation Output (Static Reference)
-
-When \`docsEnabled\` is \`true\` in \`.wunderkind/wunderkind.config.jsonc\`, write persistent output to:
-
-\`\`\`
-<docsPath>/brand-guidelines.md
-\`\`\`
-
-Read \`.wunderkind/wunderkind.config.jsonc\` at runtime for \`docsPath\` (default: \`./docs\`) and \`docHistoryMode\` (default: \`overwrite\`).
-
-**History modes:**
-- \`overwrite\` — Replace the file contents each time.
-- \`append-dated\` — Append a dated section to the file.
-- \`new-dated-file\` — Create a new file with a date suffix.
-- \`overwrite-archive\` — Overwrite the current file and archive the old one.
+${persistentContextSection}
 
 ## Delegation Patterns
 

package/dist/agents/brand-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"brand-builder.js","sourceRoot":"","sources":["../../src/agents/brand-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,IAAI,GAAc,SAAS,CAAA;AAEjC,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE;QACR;YACE,MAAM,EAAE,mBAAmB;YAC3B,OAAO,EACL,0HAA0H;SAC7H;KACF;IACD,OAAO,EAAE;QACP,0DAA0D;QAC1D,4CAA4C;QAC5C,qCAAqC;QACrC,gDAAgD;QAChD,yDAAyD;KAC1D;IACD,SAAS,EAAE;QACT,sDAAsD;QACtD,uDAAuD;QACvD,uCAAuC;QACvC,gGAAgG;KACjG;CACF,CAAA;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,YAAY,GAAG,2BAA2B,CAAC;QAC/C,OAAO;QACP,MAAM;QACN,aAAa;KACd,CAAC,CAAA;IAEF,OAAO;QACL,WAAW,EACT,qoBAAqoB;QACvoB,IAAI,EAAE,IAAI;QACV,KAAK;QACL,WAAW,EAAE,GAAG;QAChB,GAAG,YAAY;QACf,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+FA2QmF;KAC5F,CAAA;AACH,CAAC;AAED,uBAAuB,CAAC,IAAI,GAAG,IAAI,CAAA"}
+{"version":3,"file":"brand-builder.js","sourceRoot":"","sources":["../../src/agents/brand-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAA;AAE3E,MAAM,IAAI,GAAc,SAAS,CAAA;AAEjC,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE;QACR;YACE,MAAM,EAAE,mBAAmB;YAC3B,OAAO,EACL,0HAA0H;SAC7H;KACF;IACD,OAAO,EAAE;QACP,0DAA0D;QAC1D,4CAA4C;QAC5C,qCAAqC;QACrC,gDAAgD;QAChD,yDAAyD;KAC1D;IACD,SAAS,EAAE;QACT,sDAAsD;QACtD,uDAAuD;QACvD,uCAAuC;QACvC,gGAAgG;KACjG;CACF,CAAA;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,YAAY,GAAG,2BAA2B,CAAC;QAC/C,OAAO;QACP,MAAM;QACN,aAAa;KACd,CAAC,CAAA;IAEF,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;QAC7D,SAAS,EAAE,yGAAyG;QACpH,SAAS,EAAE,mEAAmE;QAC9E,QAAQ,EAAE,qEAAqE;KAChF,CAAC,CAAA;IAEF,OAAO;QACL,WAAW,EACT,qoBAAqoB;QACvoB,IAAI,EAAE,IAAI;QACV,KAAK;QACL,WAAW,EAAE,GAAG;QAChB,GAAG,YAAY;QACf,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwNV,wBAAwB;;;;;;;;;;;;;;;;;;;;;;+FAsBqE;KAC5F,CAAA;AACH,CAAC;AAED,uBAAuB,CAAC,IAAI,GAAG,IAAI,CAAA"}

package/dist/agents/ciso.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ciso.d.ts","sourceRoot":"","sources":["../../src/agents/ciso.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAa,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAKhE,eAAO,MAAM,aAAa,EAAE,mBAyB3B,CAAA;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAyV1D;yBAzVe,eAAe"}
+{"version":3,"file":"ciso.d.ts","sourceRoot":"","sources":["../../src/agents/ciso.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAa,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAMhE,eAAO,MAAM,aAAa,EAAE,mBAyB3B,CAAA;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAiU1D;yBAjUe,eAAe"}