@grant-vine/wunderkind 0.5.0 → 0.9.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "wunderkind",
-  "version": "0.5.0",
-  "description": "Wunderkind — specialist AI agents for any software product team, built as an oh-my-opencode addon",
+  "version": "0.9.0",
+  "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

@@ -1,8 +1,35 @@
 # Wunderkind
 
-Wunderkind — specialist AI agent addon for OpenCode that extends your team with eight professional agents covering marketing, design, product, engineering, brand building, QA, operations, and security.
+Wunderkind — specialist AI agent addon for OpenCode that extends your team with 12 professional agents covering marketing, design, product, engineering, brand building, QA, operations, security, devrel, legal, support, and data analysis.
 
-**Requires [OpenCode](https://opencode.ai) and [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode).** This package cannot be used standalone.
+**Requires [OpenCode](https://opencode.ai) and [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent).** This package cannot be used standalone.
+
+> [!IMPORTANT]
+> **Breaking change (0.7.0)**: This is a pre-1.0 release. Older installs are not supported. Please ensure you are using the latest version of both Wunderkind and oh-my-openagent.
+
+---
+
+## CLI
+
+Wunderkind provides a tiered CLI for installation, project setup, and health checks.
+
+| Command | Purpose | Modifies |
+|---|---|---|
+| `wunderkind install` | Registers the plugin in OpenCode | `opencode.json` (Global or Project) |
+| `wunderkind upgrade` | Upgrade lifecycle entry point for existing installs | None yet (surface only) |
+| `wunderkind init` | Bootstraps a project with soul files | `.wunderkind/`, `AGENTS.md`, `.sisyphus/` |
+| `wunderkind doctor` | Read-only diagnostics | None |
+| `wunderkind uninstall` | Safely removes Wunderkind plugin wiring | OpenCode plugin config (+ global Wunderkind config when applicable) |
+| `wunderkind gitignore` | Adds AI traces to `.gitignore` | `.gitignore` |
+
+---
+
+## Install vs Init
+
+Wunderkind distinguishes between **installing** the plugin and **initializing** a project:
+
+1. **Install** (`wunderkind install`): Adds `@grant-vine/wunderkind` to your OpenCode configuration. This makes the agents available to your AI assistant. You typically do this once globally.
+2. **Init** (`wunderkind init`): Prepares the current directory for high-context agent work. It creates the `.wunderkind/` configuration directory, the `AGENTS.md` project knowledge base, and optional documentation output folders.
 
 ---
 
@@ -30,30 +57,26 @@ The guide contains all flags for non-interactive install so the agent can run a
 ### Interactive TUI (recommended)
 
 ```bash
-bunx @grant-vine/wunderkind
+bunx @grant-vine/wunderkind install
 ```
 
 or
 
-```bash
-npx @grant-vine/wunderkind
-```
-
 The TUI will guide you through:
-1. Installing oh-my-opencode if it isn't already (runs its own setup flow first).
+1. Installing oh-my-openagent if it isn't already (runs its own setup flow first).
 2. Selecting the install scope (Global vs Project).
-3. Configuring your project context: region, industry, and data-protection regulations.
-4. Tailoring agent personalities and your team's culture baseline.
+3. Configuring your shared baseline context: region, industry, and data-protection regulations.
+4. Optionally initializing the current project immediately.
 
 ### Non-interactive install
 
 For CI/CD or scripted environments, use the `install` command with the `--no-tui` flag.
 
-> **oh-my-opencode must already be installed** before running non-interactive mode. If it isn't, install it first:
+> **oh-my-openagent must already be installed** before running non-interactive mode. If it isn't, install it first:
 > ```bash
 > bunx oh-my-opencode install --no-tui --claude=yes --gemini=no --copilot=yes
 > ```
-> See the [oh-my-opencode docs](https://github.com/code-yeongyu/oh-my-opencode) for all available options.
+> See the [oh-my-openagent docs](https://github.com/code-yeongyu/oh-my-openagent) for all available options.
 
 ```bash
 bunx @grant-vine/wunderkind install --no-tui \
@@ -73,6 +96,121 @@ bunx @grant-vine/wunderkind install --no-tui \
   --primary-regulation=CCPA
 ```
 
+> Running `wunderkind` with no subcommand now shows help and exits. Installation must be explicit via `wunderkind install`.
+
+---
+
+## Upgrade
+
+Wunderkind exposes an explicit upgrade lifecycle command:
+
+```bash
+wunderkind upgrade --scope=global
+```
+
+Current first-wave upgrade behavior is intentionally narrow:
+- it validates that Wunderkind is already installed in the requested scope
+- it preserves all project-local soul/docs settings
+- it currently behaves as a safe no-op until future baseline override flags are introduced
+
+This keeps the lifecycle concept explicit without overloading `install`.
+
+---
+
+## Init
+
+Initialize the current directory as a Wunderkind project to enable advanced features like Documentation Output and agent context persistence.
+
+```bash
+wunderkind init [options]
+```
+
+### Options
+
+| Option | Description | Default |
+|---|---|---|
+| `--docs-path <path>` | Relative path for agent docs output | `./docs` |
+| `--docs-history-mode <mode>` | Update style for documentation | `overwrite` |
+| `--docs-enabled <yes\|no>` | Enable or disable documentation output | `no` |
+| `--no-tui` | Skip interactive prompts | (false) |
+
+Interactive `wunderkind init` is where team culture, org structure, all agent personality customizations, and docs-output settings are set.
+
+`wunderkind init` creates the following project "soul files":
+- `.wunderkind/wunderkind.config.jsonc` — Project-specific configuration
+- `AGENTS.md` — Project knowledge base for agents
+- `.sisyphus/` — Directory for agent planning, notepads, and evidence
+- `<docsPath>/README.md` — Auto-generated documentation index (if enabled)
+
+### Documentation History Modes
+
+| Mode | Description |
+|---|---|
+| `overwrite` | Replaces the file contents each time (default) |
+| `append-dated` | Appends a new dated section to the file |
+| `new-dated-file` | Creates a new file with a date suffix |
+| `overwrite-archive` | Overwrites the current file and archives the old one |
+
+### JSON Schema
+
+Generated Wunderkind config files now include a top-level `$schema` field for editor validation.
+
+- Latest schema URL:
+  - `https://raw.githubusercontent.com/grant-vine/wunderkind/main/schemas/wunderkind.config.schema.json`
+- Immutable tagged schema URLs should use the same path on a release tag:
+  - `https://raw.githubusercontent.com/grant-vine/wunderkind/<tag>/schemas/wunderkind.config.schema.json`
+
+The schema is scope-aware:
+- global config validates only baseline fields (`region`, `industry`, `primaryRegulation`, `secondaryRegulation`)
+- project config validates only soul/personality/docs fields
+
+---
+
+## Doctor
+
+Run diagnostics to verify your installation, configuration, and project health.
+
+```bash
+wunderkind doctor
+```
+
+`wunderkind doctor` reports:
+- Installed version and scope (Global vs Project)
+- Location of configuration files
+- Presence and status of project soul files (in a project context)
+- Current Documentation Output configuration and index status
+
+`wunderkind doctor` is strictly read-only and makes no changes to your filesystem.
+
+---
+
+## Uninstall
+
+Safely remove Wunderkind plugin/config wiring:
+
+```bash
+wunderkind uninstall
+```
+
+Optional scope targeting:
+
+```bash
+wunderkind uninstall --scope=global
+wunderkind uninstall --scope=project
+```
+
+`wunderkind uninstall` removes Wunderkind plugin registration from OpenCode config. On global uninstall it also removes `~/.wunderkind/wunderkind.config.jsonc` (and the parent `~/.wunderkind/` directory if it becomes empty). For safety, it intentionally leaves project-local customization/bootstrap artifacts untouched (`.wunderkind/`, `AGENTS.md`, `.sisyphus/`, docs folders).
+
+---
+
+## Documentation Output
+
+When enabled, agents can persist their decisions and strategies to your project's docs folder.
+
+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.
+
 ---
 
 ## Install Scope
@@ -82,29 +220,28 @@ bunx @grant-vine/wunderkind install --no-tui \
 | `global` (default) | Adds the plugin to `~/.config/opencode/opencode.json`. Agents are available in all projects. |
 | `project` | Adds the plugin to `./opencode.json` (created if missing). Agents are limited to the current project. |
 
-Wunderkind writes its own agent config to a separate file — it never modifies your existing oh-my-opencode configuration. Removing Wunderkind leaves oh-my-opencode intact.
-
-| Scope | Agent config written to |
-|---|---|
-| `global` | `~/.wunderkind/oh-my-opencode.json` |
-| `project` | `.wunderkind/oh-my-opencode.json` |
+Wunderkind writes its own agent config to a separate file — it never modifies your existing oh-my-openagent configuration. Removing Wunderkind leaves oh-my-openagent intact.
 
 ---
 
 ## Agents
 
-| Agent Key | Role | Model |
+| Agent Key | Role | Category |
 |---|---|---|
-| `wunderkind:marketing-wunderkind` | CMO-calibre strategist | inherits from oh-my-opencode |
-| `wunderkind:creative-director` | Brand & UI/UX lead | gemini-2.0-flash |
-| `wunderkind:product-wunderkind` | VP Product | inherits from oh-my-opencode |
-| `wunderkind:fullstack-wunderkind` | CTO-calibre engineer | inherits from oh-my-opencode |
-| `wunderkind:brand-builder` | Community, PR, thought leadership | inherits from oh-my-opencode |
-| `wunderkind:qa-specialist` | TDD, coverage, user story review | inherits from oh-my-opencode |
-| `wunderkind:operations-lead` | SRE/SLO, runbooks, incident response | inherits from oh-my-opencode |
-| `wunderkind:ciso` | Security architecture, OWASP, compliance | inherits from oh-my-opencode |
-
-Agent models default to whatever provider you selected during oh-my-opencode setup (read from `agents.sisyphus.model` in your oh-my-opencode config). The creative-director uses Gemini regardless, as it requires a multimodal model.
+| `wunderkind:marketing-wunderkind` | CMO-calibre strategist | writing |
+| `wunderkind:creative-director` | Brand & UI/UX lead | visual-engineering |
+| `wunderkind:product-wunderkind` | VP Product | writing |
+| `wunderkind:fullstack-wunderkind` | CTO-calibre engineer | unspecified-high |
+| `wunderkind:brand-builder` | Community, PR, thought leadership | writing |
+| `wunderkind:qa-specialist` | TDD, coverage, user story review | unspecified-high |
+| `wunderkind:operations-lead` | SRE/SLO, runbooks, incident response | unspecified-high |
+| `wunderkind:ciso` | Security architecture, OWASP, compliance | unspecified-high |
+| `wunderkind:devrel-wunderkind` | Developer relations and advocacy | writing |
+| `wunderkind:legal-counsel` | Legal and regulatory compliance | writing |
+| `wunderkind:support-engineer` | Technical support and troubleshooting | writing |
+| `wunderkind:data-analyst` | Data analysis and insights | writing |
+
+Agent models are determined by category inheritance configured in `oh-my-opencode.jsonc`. Each agent maps to a category (`writing`, `unspecified-high`, or `visual-engineering`) and inherits the model defined in the top-level `categories` section of that file.
 
 ---
 
@@ -125,20 +262,23 @@ Agent models default to whatever provider you selected during oh-my-opencode set
 
 ## Configuration
 
-Wunderkind uses a hierarchical configuration system. The per-project config is merged on top of the global baseline at runtime — project values take precedence.
+Wunderkind uses a split configuration model:
+- global config stores shared market/regulation baseline
+- project config stores soul/personality/docs settings
 
 | File | Scope |
 |---|---|
 | `~/.wunderkind/wunderkind.config.jsonc` | Global baseline (applies to all projects) |
-| `.wunderkind/wunderkind.config.jsonc` | Per-project override |
+| `.wunderkind/wunderkind.config.jsonc` | Per-project soul/personality/docs settings |
 
-Edit either file directly to change any value after install. The installer pre-fills both files with the values you provided during setup.
+Edit the global file to change region/industry/regulation defaults after install. Edit the project file to change team culture, personalities, or docs-output settings after init.
 
 ### Configuration Reference
 
 ```jsonc
-// Wunderkind configuration — edit these values to tailor agents to your project context
+// Global baseline config
 {
+  "$schema": "https://raw.githubusercontent.com/grant-vine/wunderkind/main/schemas/wunderkind.config.schema.json",
   // Geographic region — e.g. "South Africa", "United States", "United Kingdom", "Australia"
   "region": "South Africa",
   // Industry vertical — e.g. "SaaS", "FinTech", "eCommerce", "HealthTech"
@@ -146,31 +286,37 @@ Edit either file directly to change any value after install. The installer pre-f
   // Primary data-protection regulation — e.g. "GDPR", "POPIA", "CCPA", "LGPD"
   "primaryRegulation": "POPIA",
   // Optional secondary regulation
-  "secondaryRegulation": "",
+  "secondaryRegulation": ""
+}
+```
 
+```jsonc
+// Project-local soul/docs config
+{
+  "$schema": "https://raw.githubusercontent.com/grant-vine/wunderkind/main/schemas/wunderkind.config.schema.json",
   // Team culture baseline — affects all agents' communication style and decision rigour
-  // "formal-strict" | "pragmatic-balanced" | "experimental-informal"
   "teamCulture": "pragmatic-balanced",
   // Org structure — "flat" (peers) | "hierarchical" (domain authority applies)
   "orgStructure": "flat",
 
   // Agent personalities — controls each agent's default character archetype
-  // CISO: "paranoid-enforcer" | "pragmatic-risk-manager" | "educator-collaborator"
   "cisoPersonality": "pragmatic-risk-manager",
-  // CTO/Fullstack: "grizzled-sysadmin" | "startup-bro" | "code-archaeologist"
   "ctoPersonality": "code-archaeologist",
-  // CMO/Marketing: "data-driven" | "brand-storyteller" | "growth-hacker"
   "cmoPersonality": "data-driven",
-  // QA: "rule-enforcer" | "risk-based-pragmatist" | "rubber-duck"
   "qaPersonality": "risk-based-pragmatist",
-  // Product: "user-advocate" | "velocity-optimizer" | "outcome-obsessed"
   "productPersonality": "outcome-obsessed",
-  // Operations: "on-call-veteran" | "efficiency-maximiser" | "process-purist"
   "opsPersonality": "on-call-veteran",
-  // Creative Director: "perfectionist-craftsperson" | "bold-provocateur" | "pragmatic-problem-solver"
   "creativePersonality": "pragmatic-problem-solver",
-  // Brand Builder: "community-evangelist" | "pr-spinner" | "authentic-builder"
-  "brandPersonality": "authentic-builder"
+  "brandPersonality": "authentic-builder",
+  "devrelPersonality": "dx-engineer",
+  "legalPersonality": "pragmatic-advisor",
+  "supportPersonality": "systematic-triage",
+  "dataAnalystPersonality": "insight-storyteller",
+
+  // Documentation Output (Init-only customizations)
+  "docsEnabled": false,
+  "docsPath": "./docs",
+  "docHistoryMode": "overwrite"
 }
 ```
 
@@ -183,7 +329,6 @@ Edit either file directly to change any value after install. The installer pre-f
 ```
 .wunderkind/
   wunderkind.config.jsonc     # per-project config override
-  oh-my-opencode.json         # wunderkind agent model config (project scope)
 ```
 
 ### Global (`~/.wunderkind/`)
@@ -191,7 +336,6 @@ Edit either file directly to change any value after install. The installer pre-f
 ```
 ~/.wunderkind/
   wunderkind.config.jsonc     # global config baseline
-  oh-my-opencode.json         # wunderkind agent model config (global scope)
 ```
 
 ---
@@ -223,7 +367,7 @@ This adds `.wunderkind/`, `AGENTS.md`, `.sisyphus/`, and `.opencode/` to your `.
 ## Requirements
 
 - [OpenCode](https://opencode.ai)
-- [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)
+- [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent)
 - Node.js 18+ or Bun 1+
 
 ---

package/agents/brand-builder.md

@@ -6,7 +6,7 @@ description: >
 
 # Brand Builder — Soul
 
-You are the **Brand Builder**. Before acting, read `wunderkind.config.jsonc` and load:
+You are the **Brand Builder**. Before acting, read `.wunderkind/wunderkind.config.jsonc` and load:
 - `brandPersonality` — your character archetype:
   - `community-evangelist`: Community is infrastructure. Invest in it consistently, show up constantly, and treat members as the most valuable asset. People first, always.
   - `pr-spinner`: Narrative is everything. Every story angle, every journalist relationship, every moment of earned media leverage matters. Craft the message relentlessly.
@@ -46,7 +46,7 @@ Your north star: *build the brand by doing the work publicly and being genuinely
 - Identify relevant product forums, Slack communities, Discord servers, subreddits, LinkedIn groups
 - Engagement strategy for each: how to add value before asking for anything
 - Weekly networking cadence: who to connect with, what to share, what conversations to enter
-- Conference and event calendar: which events matter, which are worth sponsoring vs attending vs speaking at — read `wunderkind.config.jsonc` for `region` and `industry` to prioritise regionally relevant events
+- Conference and event calendar: which events matter, which are worth sponsoring vs attending vs speaking at — read `.wunderkind/wunderkind.config.jsonc` for `region` and `industry` to prioritise regionally relevant events
 - Partnership opportunities: integration partners, content collaborators, co-marketing
 
 ### PR & Brand Narrative
@@ -100,7 +100,7 @@ Audit the current community presence across all platforms.
 ### `/forum-research <industry/product>`
 Find the highest-value forums, communities, and events for a given domain.
 
-**First**: read `wunderkind.config.jsonc` for `region` and `industry` to filter for regionally relevant communities and events. If blank, return a globally diverse list.
+**First**: read `.wunderkind/wunderkind.config.jsonc` for `region` and `industry` to filter for regionally relevant communities and events. If blank, return a globally diverse list.
 
 ```typescript
 task(
@@ -218,6 +218,55 @@ task(
 
 ---
 
+---
+
+## Persistent Context (.sisyphus/)
+
+When operating as a subagent inside an oh-my-openagent 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.
+
+After writing, run `/docs-index` to update the project documentation index.
+
+## Delegation Patterns
+
+When technical documentation or developer education requests arise:
+
+```typescript
+task(
+  subagent_type="devrel-wunderkind",
+  description="Create developer education content for [topic]",
+  prompt="...",
+  run_in_background=false
+)
+```
+---
+
 ## Hard Rules
 
 1. **Never pay for vanity**: follower counts, impressions, and reach without engagement are not success metrics

package/agents/ciso.md

@@ -6,7 +6,7 @@ description: >
 
 # CISO — Soul
 
-You are the **CISO** (Chief Information Security Officer). Before acting, read `wunderkind.config.jsonc` and load:
+You are the **CISO** (Chief Information Security Officer). Before acting, read `.wunderkind/wunderkind.config.jsonc` and load:
 - `cisoPersonality` — your character archetype:
   - `paranoid-enforcer`: Everything is a threat until proven otherwise. Zero tolerance, zero exceptions. Block first, ask questions after.
   - `pragmatic-risk-manager`: Paranoid but practical. Prioritise by real-world exploitability. Recommend mitigations, not just red-flags.
@@ -21,7 +21,7 @@ Also read:
 - `primaryRegulation` — applies to all breach notification and data-handling decisions
 - `region` and `industry` — for jurisdiction-specific compliance requirements
 
-If `wunderkind.config.jsonc` is absent, default to: `pragmatic-risk-manager`, `flat` org, GDPR as primary regulation.
+If `.wunderkind/wunderkind.config.jsonc` is absent, default to: `pragmatic-risk-manager`, `flat` org, GDPR as primary regulation.
 
 ---
 
@@ -190,7 +190,7 @@ task(
   category="unspecified-high",
   load_skills=["wunderkind:compliance-officer"],
   description="Breach notification assessment for [incident type]",
-  prompt="A security incident involving personal data has occurred: [incident details]. Assess breach notification obligations: 1) Does this require regulator notification? If so, what is the timeline and which regulator? (Check wunderkind.config.jsonc for PRIMARY_REGULATION). 2) Do affected individuals need to be notified? 3) Draft the regulator notification. 4) Draft the individual notification if required. 5) Document everything for the ROPA breach record.",
+  prompt="A security incident involving personal data has occurred: [incident details]. Assess breach notification obligations: 1) Does this require regulator notification? If so, what is the timeline and which regulator? (Check .wunderkind/wunderkind.config.jsonc for PRIMARY_REGULATION). 2) Do affected individuals need to be notified? 3) Draft the regulator notification. 4) Draft the individual notification if required. 5) Document everything for the ROPA breach record.",
   run_in_background=false
 )
 ```
@@ -278,6 +278,56 @@ task(
 
 ---
 
+---
+
+## Persistent Context (.sisyphus/)
+
+When operating as a subagent inside an oh-my-openagent 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, prior findings, and remediation decisions.
+
+**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.
+
+After writing, run `/docs-index` to update the project documentation index.
+
+## Delegation Patterns
+
+When OSS licensing, TOS/Privacy Policy, DPAs, CLAs, or contract review is needed:
+
+```typescript
+task(
+  subagent_type="legal-counsel",
+  description="Review legal matter: [topic]",
+  prompt="...",
+  run_in_background=false
+)
+```
+---
+
 ## Hard Rules
 
 1. **No security through obscurity** — controls must work even if the implementation is known

package/agents/creative-director.md

@@ -6,7 +6,7 @@ description: >
 
 # Creative Director — Soul
 
-You are the **Creative Director**. Before acting, read `wunderkind.config.jsonc` and load:
+You are the **Creative Director**. Before acting, read `.wunderkind/wunderkind.config.jsonc` and load:
 - `creativePersonality` — your character archetype:
   - `perfectionist-craftsperson`: Every pixel must earn its place. Pixel-perfect or not shipped. Design is a discipline, not decoration.
   - `bold-provocateur`: Push the boundaries. Safe is forgettable. The best designs divide opinion and start conversations.
@@ -240,4 +240,39 @@ Every design decision must meet:
 - **Typography**: No more than 2 typefaces per project. Body text minimum 16px. Line-height minimum 1.5 for body copy.
 - **Colour**: Semantic tokens only in components — never hard-coded hex values in component files.
 - **Responsiveness**: Every component designed mobile-first. Test at 375px, 768px, 1280px, 1440px breakpoints.
-- **States**: Every interactive element must have default, hover, focus, active, and disabled states defined.
+- **States**: Every interactive element must have default, hover, focus, active, and disabled states defined.
+
+---
+
+## Persistent Context (.sisyphus/)
+
+When operating as a subagent inside an oh-my-openagent 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 brand context, design decisions, and visual 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.
+
+After writing, run `/docs-index` to update the project documentation index.