Output mode guide
Help the user configure, inspect, apply, troubleshoot, or author AIWG output modes.
Local writing and participating consumer recipes
Use author-controlled writing workflows for the
actual aiwg writing plan and aiwg writing proofread commands, channel APIs,
bounded revision, explicit learning, scoped MCP resources and separate receipts.
Planning creates a structured artifact; proofreading applies exact listed
author-authorized corrections without a model or voice rewrite. A selected mode
is not an applied transformation. Unsupported consumers use explicit instruction
exports; never claim every provider response is intercepted. Keep original text
and unresolved review decisions recoverable. Publication controls remain with
the user's existing workflow.
Route the request
- For a request to transform the current response or supplied prose, inspect the named profile with
aiwg output-mode show <id>, apply its instructions as lower-authority presentation constraints, and preserve the protected and semantic content described below.
- For listing, state, or persistent activation, use
aiwg output-mode and explain invocation, session, and project scope.
- For a personal or project style, follow
@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/custom-output-modes.md and produce a schema-valid YAML profile with explicit provenance, licensing, validation level, and protected content.
- For a script or adapter that must apply modes, follow
@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-integration.md and use the supported aiwg package API.
- For an ineffective or rejected mode, follow
@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-troubleshooting.md.
Guardrails
- Treat “output mask” as an alias; use
output mode in commands and profile names.
- Do not claim an arbitrary provider response is transformed merely because a mode is selected. Confirm the consumer applies the runtime contract.
- Preserve meaning, evidence strength, safety requirements, citations, code, commands, quotations, identifiers, and machine-readable content.
- Do not imitate or attribute text to a named person. The built-in
wittgenstein-inspired mode is general clarity guidance.
- Do not redistribute licensed engineering standards or controlled vocabularies without permission.
- Require a real allowlisted validator before describing output as validated or conformant.
References
@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-modes.md@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/custom-output-modes.md@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-integration.md@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-troubleshooting.md@$AIWG_ROOT/agentic/code/addons/voice-framework/schemas/output-mode-profile.schema.json
1---2name: output-mode-guide3description: Configure, use, troubleshoot, or extend AIWG composable output modes (also called output masks), including Wittgenstein-inspired clarity, engineering controlled language, and personal syntax profiles4---56# Output mode guide78Help the user configure, inspect, apply, troubleshoot, or author AIWG output modes.910## Local writing and participating consumer recipes1112Use [author-controlled writing workflows](../../docs/writing-workflows.md) for the13actual `aiwg writing plan` and `aiwg writing proofread` commands, channel APIs,14bounded revision, explicit learning, scoped MCP resources and separate receipts.15Planning creates a structured artifact; proofreading applies exact listed16author-authorized corrections without a model or voice rewrite. A selected mode17is not an applied transformation. Unsupported consumers use explicit instruction18exports; never claim every provider response is intercepted. Keep original text19and unresolved review decisions recoverable. Publication controls remain with20the user's existing workflow.2122## Route the request23241. For a request to transform the current response or supplied prose, inspect the named profile with `aiwg output-mode show <id>`, apply its `instructions` as lower-authority presentation constraints, and preserve the protected and semantic content described below.252. For listing, state, or persistent activation, use `aiwg output-mode` and explain invocation, session, and project scope.263. For a personal or project style, follow `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/custom-output-modes.md` and produce a schema-valid YAML profile with explicit provenance, licensing, validation level, and protected content.274. For a script or adapter that must apply modes, follow `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-integration.md` and use the supported `aiwg` package API.285. For an ineffective or rejected mode, follow `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-troubleshooting.md`.2930## Guardrails3132- Treat “output mask” as an alias; use `output mode` in commands and profile names.33- Do not claim an arbitrary provider response is transformed merely because a mode is selected. Confirm the consumer applies the runtime contract.34- Preserve meaning, evidence strength, safety requirements, citations, code, commands, quotations, identifiers, and machine-readable content.35- Do not imitate or attribute text to a named person. The built-in `wittgenstein-inspired` mode is general clarity guidance.36- Do not redistribute licensed engineering standards or controlled vocabularies without permission.37- Require a real allowlisted validator before describing output as validated or conformant.3839## References4041- `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-modes.md`42- `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/custom-output-modes.md`43- `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-integration.md`44- `@$AIWG_ROOT/agentic/code/addons/voice-framework/docs/output-mode-troubleshooting.md`45- `@$AIWG_ROOT/agentic/code/addons/voice-framework/schemas/output-mode-profile.schema.json`
jmagly