ckb/.agents/modules/voice/module.yaml
Michał Kopeć c57ddceffd Template 2.2.0: voice and convert modules
- 2.1.0 new opt-in `voice` module (D-0020): skill ckb-voice rewrites every
  prose file written under apply_to (outputs/answers, documents, reports,
  PROJECT-OVERVIEW) in a voice whose profile is a wiki page,
  wiki/voice/<name>.md (type voice-profile); settings in ckb.yaml (mode,
  profile, writer, apply_to, skip, chat); frozen spans never change, vague
  claims flagged not cut; `writer:` delegates to an external rewriting
  skill such as a personal ghost-writer. ckb-module writes a manifest's
  default_config into the entry's config:. Eval ckb-module/install-voice.
- 2.2.0 new opt-in `convert` module (D-0021): skill ckb-convert and
  convert.py turn Markdown into Word/ODT/PDF/HTML through pandoc with a
  house style in templates/styles/; unit tests and eval
  ckb-module/install-convert.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 20:57:39 +01:00

45 lines
1.7 KiB
YAML

# Cascade KB module manifest — read by `ckb-module` on install/uninstall.
# See docs/decisions/0020-voice-module.md.
name: voice
title: Voice for outgoing text
version: 1.0.0
requires_kb_schema: "1.7"
summary: >
Rewrites every text the KB sends out (kept answers, documents, reports, the
project overview) in a writing voice whose profile is a page in
wiki/voice/, so it reads like the team and not like a model. Facts, quotes,
sources and code are never touched.
skills:
- ckb-voice
# No scaffold: wiki/voice/ is created, and logged, by ckb-voice when the first
# profile is written. A module install never writes wiki pages.
agents_fragment: fragments/agents-routing.md
gitignore_fragment: fragments/gitignore.snippet
# Default settings, written under this module's `config:` in ckb.yaml on
# install. ckb-voice owns them afterwards ("set the voice mode to ask").
default_config:
mode: auto # auto | ask | off
profile: house # wiki/voice/<profile>.md used when nothing else names one
writer: ckb-voice # or the name of another rewriting skill, e.g. ghost-writer
apply_to: # path prefixes whose prose files go through the voice
- outputs/answers/
- outputs/documents/
- outputs/reports/
- PROJECT-OVERVIEW
skip: # never rewritten, even under an apply_to prefix
- outputs/okf/
- outputs/starlight/
chat: false # true = also rewrite answers given in the chat
schema_additions:
types:
- voice-profile # wiki/voice/<name>.md: a writing voice, maintained by ckb-voice
fields:
- voice # on an output file: the profile it was written in
# on a person's workload/profiles/ page: their default voice
depends_on: []