Christian Nennemann
d94688ca1b
Remove verbose YAML examples, bash pseudo-code, tutorial prose, and motivational content from configuration/integration skills while preserving all operational protocols, reference tables, and rules. Skills trimmed: domains, colette-bridge, multi-project, cost-tracking, git-integration, custom-archetypes, workflow-design, templates, autonomous-mode, progress, presence.
3.5 KiB
name, description
| name | description |
|---|---|
| colette-bridge | 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:
- Check for
colette.yamlin project root - If found: activate bridge, set domain to
writing - 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:
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:
- Archetype definition
- Domain-specific review focus
- Colette bundle (filtered for this archetype)
- Task description
- Phase-specific artifacts
- Cycle feedback (if cycle 2+)