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.
100 lines
3.5 KiB
Markdown
100 lines
3.5 KiB
Markdown
---
|
|
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+)
|