---
name: colette-bridge
description: |
  Bridges ArcheFlow with the Colette writing platform. Auto-detects colette.yaml in the project
  root, resolves voice profiles, personas, and character sheets, then builds a summarized context
  bundle that gets injected into every agent prompt via artifact routing. Eliminates manual
  copy-pasting of writing context into agent prompts.
  <example>Automatically loaded when colette.yaml is detected at run.start</example>
  <example>User: "archeflow:run" in a project with colette.yaml</example>
---

# Colette Bridge -- Writing Context Auto-Loader

When `colette.yaml` exists in the project root, this skill loads voice profiles, personas, character sheets, and project rules into a context bundle filtered per archetype.

## Activation

At `run.start`, after domain detection but before Plan phase:
1. Check for `colette.yaml` in project root
2. If found: activate bridge, set domain to `writing`
3. If not found: skip silently

## File Resolution

Colette projects reference files by ID (e.g., `vp-giesing-gschichten-v1`). The bridge resolves them:

| Priority | Location |
|----------|----------|
| 1 | Explicit path in `colette.yaml` (has `/` or `.yaml`) |
| 2 | Project root subdirectories (`./profiles/<id>.yaml`) |
| 3 | Parent `writing.colette/` dir (`../writing.colette/profiles/<id>.yaml`) |

**What gets resolved:**

| Source | colette.yaml field | Search subdirs |
|--------|-------------------|----------------|
| Voice profile | `voice.profile` | `profiles/` |
| Persona | `writing.persona` or inferred from profile | `personas/` |
| Characters | Auto-discovered | `characters/*.yaml` |
| Series config | `series` section | `colette.yaml` itself |
| Project rules | Always | `CLAUDE.md` in project root |

Missing files emit a warning event but do not abort the run.

## Context Bundle

Generated at `.archeflow/context/colette-bundle.md`. Summarized, not raw YAML. Target: under 1500 tokens.

**Summarization rules:**
- Voice dimensions: key + value (no YAML wrapper)
- Verboten/erlaubt: bullet list, truncate items over 15 words
- Characters: name, role, age, top 3 traits, first sentence of speech pattern, relationships
- Persona bio: max 2 sentences
- CLAUDE.md: only writing rules, skip meta/git/cost config

## Caching

Bundle regenerated only when source file mtimes are newer than the bundle. If all sources are older, reuse cached bundle.

## Per-Agent Attention Filters

Not every agent needs the full bundle:

| Archetype | Receives |
|-----------|----------|
| Explorer | Full bundle |
| Creator | Voice dimensions + persona rules + characters |
| Maker | Full bundle |
| Guardian | Characters + series shared_concepts |
| Sage | Full voice profile (incl. verboten/erlaubt) + persona rules |
| Trickster | Characters + series glossary |

Custom archetypes inherit the filter of their closest base archetype. Override with `colette_filter` in archetype frontmatter:

```yaml
colette_filter: [voice_profile, persona, characters]
```

Section keys: `voice_profile`, `persona`, `characters`, `series`, `project_rules`, `full`.

## Run Integration

```
run.start
  +-- Domain detection -> colette.yaml found -> domain = writing
  +-- Colette Bridge activation
  |     +-- Resolve files
  |     +-- Check/refresh bundle cache
  |     +-- Register bundle in artifact routing
  +-- Continue to Plan phase
```

**Prompt injection order:**
1. Archetype definition
2. Domain-specific review focus
3. Colette bundle (filtered for this archetype)
4. Task description
5. Phase-specific artifacts
6. Cycle feedback (if cycle 2+)