cuioss Manage Config Skill
Per-plan configuration management for plan-specific settings stored in config.toon.
What This Skill Provides
- Per-plan config.toon management with schema validation
- Domain array management for multi-domain plans
- Field-level get/set operations with nested access support
- Multi-field retrieval
Note: workflow_skills are NOT stored in config.toon. They are resolved at runtime from marshal.json via plan-marshall-config resolve-workflow-skill.
When to Activate This Skill
Activate this skill when:
- Creating initial plan configuration
- Reading or updating plan settings
- Retrieving domains for a plan
Storage Location
Configuration is stored in the plan directory:
.plan/plans/{plan_id}/config.toon
File Format
TOON format with typed fields:
# Plan Configuration
domains[1]:
- java
commit_strategy: per_task
create_pr: true
verification_required: true
verification_command: /pm-dev-builder:builder-build-and-fix
branch_strategy: feature
Required Fields
| Field | Type | Description |
|---|---|---|
domains |
array | List of domains (e.g., java, javascript, plan-marshall-plugin-dev, generic) |
commit_strategy |
enum | per_task, per_plan, none |
Optional Fields
| Field | Values | Default | Description |
|---|---|---|---|
create_pr |
true, false | true | Create PR on finalize |
verification_required |
true, false | true | Require verification before finalize |
verification_command |
string | - | Command to run for verification |
branch_strategy |
feature, direct | feature | Feature branch or direct-to-main |
Operations
Script: pm-workflow:manage-config:manage-config
create
Create config.toon with domains configuration.
python3 .plan/execute-script.py pm-workflow:manage-config:manage-config create \
--plan-id {plan_id} \
--domains java
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
--domains |
string (comma-separated) | Yes | Domain list (e.g., java or java,javascript) |
--commit-strategy |
enum | No | per_task (default), per_plan, none |
--create-pr |
bool | No | Create PR on finalize (default from marshal.json) |
--verification-required |
bool | No | Require verification (default from marshal.json) |
--verification-command |
string | No | Verification command |
--branch-strategy |
enum | No | feature (default), direct |
--force |
flag | No | Overwrite existing config |
Output (TOON):
status: success
plan_id: my-feature
file: config.toon
created: true
config:
domains[1]:
- java
commit_strategy: per_task
create_pr: true
verification_required: true
branch_strategy: feature
get-domains
Get the domains array from config.toon.
python3 .plan/execute-script.py pm-workflow:manage-config:manage-config \
get-domains --plan-id {plan_id}
Output (TOON):
status: success
plan_id: my-feature
domains[2]:
- java
- javascript
count: 2
read
Read entire config.toon content.
python3 .plan/execute-script.py pm-workflow:manage-config:manage-config read \
--plan-id {plan_id}
Output (TOON):
status: success
plan_id: my-feature
config:
domains[1]:
- java
commit_strategy: per_task
get
Get a specific field value. Supports nested field access via dot notation.
# Simple field
python3 .plan/execute-script.py pm-workflow:manage-config:manage-config get \
--plan-id {plan_id} \
--field commit_strategy
Output (TOON):
status: success
plan_id: my-feature
field: commit_strategy
value: per_task
set
Set a specific field value.
python3 .plan/execute-script.py pm-workflow:manage-config:manage-config set \
--plan-id {plan_id} \
--field commit_strategy \
--value per_plan
Output (TOON):
status: success
plan_id: my-feature
field: commit_strategy
value: per_plan
previous: per_task
get-multi
Get multiple fields in one call.
python3 .plan/execute-script.py pm-workflow:manage-config:manage-config get-multi \
--plan-id {plan_id} \
--fields "commit_strategy,branch_strategy"
Output (TOON):
status: success
plan_id: my-feature
commit_strategy: per_task
branch_strategy: feature
Scripts
| Script | Purpose | Usage |
|---|---|---|
pm-workflow:manage-config:manage-config |
Per-plan config.toon operations | python3 .plan/execute-script.py pm-workflow:manage-config:manage-config {subcommand} --help |
Validation Rules
| Field | Valid Values |
|---|---|
| domains | lowercase identifiers (e.g., java, javascript, plan-marshall-plugin-dev, generic) |
| commit_strategy | per_task, per_plan, none |
| create_pr | true, false |
| verification_required | true, false |
| verification_command | any string |
| branch_strategy | feature, direct |
Error Handling
status: error
plan_id: my-feature
error: invalid_domain
message: Invalid domain format: Java. Must be lowercase identifier
Workflow Skill Resolution
Workflow skills are resolved from marshal.json (not config.toon):
python3 .plan/execute-script.py plan-marshall:plan-marshall-config:plan-marshall-config \
resolve-workflow-skill --domain {domain} --phase {phase}
See plan-marshall:plan-marshall-config for workflow skill resolution.
Integration Points
| Consumer | Operation | Purpose |
|---|---|---|
| plan-init-agent | create |
Create config.toon with domains |
| solution-outline-agent | get-domains |
Get domains for deliverable assignment |
| plan-execute | read, get |
Read commit strategy, verification settings |
| plan-finalize | get |
Check create_pr, branch_strategy |
Related Skills
| Skill | Purpose |
|---|---|
plan-marshall:plan-marshall-config |
Project-level marshal.json configuration, workflow skill resolution |