customise-workflow

Files (1)

• SKILL.md

SKILL.md (first lines)

# customise-workflow

AI-driven workflow customisation for the `prd-taskmaster` plugin.
Replaces manual JSON editing. Part of the plugin's companion-skills family.

**Script**: `skills/customise-workflow/script.py` (all commands output JSON)
**Plugin config root**: `.atlas-ai/` (per-project, lives alongside TaskMaster's
`.taskmaster/`)

## When to Use

Activate when the user says: "customise workflow", "customize workflow",
"adjust PRD settings", "tune the skill", "change my defaults", or
"personalise prd-taskmaster".

Skip: generating a new PRD (use `/prd:go`), executing tasks (use
HANDOFF modes), or running research expansion (use `/expand-tasks`).

## The One Rule

**The AI asks the questions and writes the config. The user never manually
edits JSON. The config file is the output, not the input.** If the user wants
tweaks beyond the curated questions, point them at `.atlas-ai/customizations/`
(see "Customizations directory" below) — do not hand them raw JSON.

## Flow

```
LOAD → ASK → VALIDATE → WRITE → VERIFY
```

### Phase 1: LOAD current config

Run the script to load existing preferences (or defaults if first run):

```bash
python3 skills/customise-workflow/script.py load-config
```

Returns JSON with current preferences across 6 categories: provider,
validation, execution, template, autonomous, gates. Writes to
`.atlas-ai/config/atlas.json` if missing, seeding defaults.

### Phase 2: ASK curated questions

Read `questions/curated-questions.md` and ask each one via `AskUserQuestion`.
The questions are curated so plain-English answers map cleanly to config keys.
Example:

```
Q1: Which AI provider do you prefer for task generation?
  Options: Gemini (free, token-efficient), Claude Code (free, Max only),
           OpenAI GPT-4, Anthropic Direct API, OpenRouter, Ollama (local)

Q2: How strict should PRD validation be?
  Options: Strict (block on NEEDS_WORK), Normal (warn but allow GOOD+),
           Lenient (accept ACCEPTABLE+)

Q3: Which execution mode should prd-taskmaster default to?
  Options: A (Plan Mode), B (Ralph loop), C (Atlas Fleet), ...

...
```

Do NOT ask all questions at once. Ask one curated question at a time and
adapt follow-ups based on answers. (Same pattern as
`superpowers:brainstorming`.)

### Phase 3: VALIDATE answers

Run the script with each user answer as it arrives. The script validates the
answer against allowed values and returns either `ok: true` or a hint about
what's wrong.

```bash
python3 skills/customise-workflow/script.py validate-answer \
  --key provider_main --value gemini-cli
```

If validation fails, re-ask the question with the hint. Never write an invalid
value.

### Phase 4: WRITE config

After all curated questions are answered, commit the config:

```bash
python3 skills/customise-workflow/script.py write-config --input /tmp/answers.json
```

This writes to `.atlas-ai/config/atlas.json` in the current project.
Idempotent — re-running customise-workflow reads and updates the existing
file. The script creates the `.atlas-ai/config/` directory if missing.

### Phase 5: VERIFY

Show the user their final config and confirm it matches their intent:

```bash
python3 skills/customise-workflow/script.py show-config
```

If the user says "that's not what I meant" for any key, re-enter Phase 2 for
just that key, re-validate, and re-write.

## Script Commands Reference

| Command | Purpose |
|---|---|
| `load-config` | Load current `.atlas-ai/config/atlas.json` (or defaults) |
| `list-questions` | Return the curated question set as JSON |
| `validate-answer --key K --value V` | Validate a single answer |
| `write-config --input <file>` | Write validated answers to `.atlas-ai/config/atlas.json` |
| `show-config` | Display current config |
| `reset-config` | Delete `.atlas-ai/config/atlas.json` (back to defaults) |

## Config Schema

`.atlas-ai/config/atlas.json` has 7 top-level keys:

From anombyte93/prd-taskmaster, MIT.

More from anombyte93/prd-taskmaster