terella 0.19.1

terella agent
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176

# Assets

Bundled agent skills and workflow definitions for terella. This directory is
the compile-time source — skills and workflows are embedded via `rust-embed`.
When materialized, they are written under terella' app-data directory
(`~/.local/share/terella` on typical Linux desktops, platform equivalent
elsewhere). Workflow templates are loaded from bundled
`assets/workflows/{preset}/`, materialized app-data workflows, and
project-local `.agents/workflows/{preset}/` overrides.

This keeps the target repo's `.agents/` directory clean for its own agent configuration.

## Skills

Skills in `skills/` are embedded at compile time and can be materialized to the
terella app-data assets directory. Project config can override individual skill
paths via `[skills]` in `terella.toml`.

| Skill | Description |
| :--- | :--- |
| `project-context` | Core project context, priorities, and key resources |
| `architecture` | High-level system design and component overview |
| `coding-standards` | Rust coding patterns and conventions |
| `testing` | Test commands, verification workflow, and submission checklist |
| `user-personas` | Adopter personas for UXR synthesis and the Personas Studio |
| `issue-tracking` | GitHub issue/PR hygiene guidance |
| `code-explorer` | Use toak CLI for codebase snapshots and LLM context |

## Workflows

Workflows are organized under `workflows/` in **preset** directories. Each preset is a named collection of workflows that appear as action buttons in the sidebar.

```
workflows/
  default/              <-- preset
    sprint-planning/    <-- workflow
      workflow.yaml
      draft.md
      finalize.md
    ideation/
      ...
  lean/                 <-- another preset (only the workflows you need)
    sprint-planning/
      workflow.yaml
      draft.md
      finalize.md
```

### Presets

A preset is a folder directly under `workflows/`. The sidebar loads whichever preset is selected and renders its workflows as action buttons. Project-local presets in `.agents/workflows/` are also discovered and can add new workflows or override bundled ones with the same workflow id.

Built-in presets:
- `default` — the standard full development lifecycle
- `deep-research` — broader research-heavy discovery and strategy workflow set
- `pm` — product-management workflows for feature briefs, competitive analysis, stakeholder updates, and planning
- `ux` — UX research/design workflows, including persona synthesis and journey mapping
- `xp` — a pure Extreme Programming preset focused on story discovery, customer signal review, XP strategy, iteration planning, collective code review, and retrospectives
- `business-development` — workflows for market research, partnership outreach, and sales prospecting
- `quality-assurance` — bug triage, regression testing, and test-plan generation
- `data-science` — dataset search, cleaning, EDA, feature engineering, model training, and model evaluation
- `software-factory` — autonomous software factory loop for GitHub Actions with chartering, backlog curation, autonomous sprint execution, CI governance hardening, and factory retrospectives

The preset selector is always shown in the sidebar when presets are available. If only one preset exists, the selector is disabled until another preset folder is added.

To create a new preset, start from scratch with only the workflows you want, or copy a preset intentionally when you really want its full workflow shape.

The active preset is stored in `terella.toml` as `workflow_preset` (defaults to `"default"`).

### Workflow files

Each workflow subdirectory contains:

- `workflow.yaml` — Metadata (name, display order, category, dependencies, context gatherer, phases)
- `draft.md` / `finalize.md` — Handlebars prompt templates with `{{variable}}` placeholders

To add a new workflow to a preset, create a subdirectory with a `workflow.yaml` in either `assets/workflows/<preset>/` for a bundled preset or `.agents/workflows/<preset>/` for a project-local preset. The sidebar picks it up on next launch.

### workflow.yaml reference

```yaml
name: Sprint Planning                 # display name in sidebar
id: sprint_planning                   # unique identifier
description: Plan the next sprint     # tooltip / documentation
pattern: two_phase                    # two_phase | one_shot | multi_round | implementation
context: sprint                       # context gatherer: sprint | strategic | retro | housekeeping | none
runner: my_custom_runner              # optional: named action from the Rust registry

ui:
  category: planning                  # groups buttons: discovery | planning | review | maintenance
  order: 50                           # sort order within category (lower = higher)
  visible: true                       # false to hide from sidebar
  requires_bot: false                 # true to disable button when no bot credentials

depends_on:                           # informational dependency graph
  - strategic_review

extra_context:                        # fetch GitHub issue bodies by label
  - name: report_synthesis
    label: uxr-synthesis

phases:
  draft:
    template: draft.md
    log_start: "Starting sprint planning draft..."
    log_complete: "Draft complete."
  finalize:
    template: finalize.md
    log_start: "Finalising sprint plan..."
    log_complete: "Sprint planning complete."

fragments:                            # reusable text blocks, included via {{> name}}
  my_fragment: |
    Shared text included with {{> my_fragment}}
```

### Default workflows

| Workflow | Category | Pattern |
| :--- | :--- | :--- |
| `ideation` | discovery | two-phase |
| `report-research` | discovery | two-phase |
| `interview` | discovery | multi-round |
| `strategic-review` | planning | two-phase |
| `roadmapper` | planning | two-phase |
| `sprint-planning` | planning | two-phase |
| `auto-merge` | maintenance | one-shot |
| `code-review` | review | one-shot |
| `security-scan` | review | one-shot |
| `security-review` | review | one-shot |
| `visual-regression` | review | one-shot |
| `deploy` | maintenance | one-shot |
| `deploy` | maintenance | one-shot |
| `retrospective` | review | two-phase |
| `housekeeping` | maintenance | two-phase |
| `refresh-agents` | maintenance | one-shot |
| `refresh-docs` | maintenance | one-shot |

### XP workflows

| Workflow | Category | Pattern |
| :--- | :--- | :--- |
| `ideation` | discovery | two-phase |
| `interview` | discovery | multi-round |
| `report-research` | discovery | two-phase |
| `strategic-review` | planning | two-phase |
| `sprint-planning` | planning | two-phase |
| `sprint-poker` | planning | two-phase |
| `pre-ipm` | planning | two-phase |
| `ipm` | planning | two-phase |
| `code-review` | review | one-shot |
| `retrospective` | review | two-phase |

### Business Development workflows

| Workflow | Category | Pattern |
| :--- | :--- | :--- |
| `market-research` | discovery | two-phase |
| `partnership-outreach` | growth | two-phase |
| `sales-prospecting` | growth | two-phase |

### Other preset workflow groups

- `pm` includes competitive analysis, feature briefs, stakeholder updates, and
  the standard discovery/planning/review loop.
- `ux` includes accessibility review, design critique, journey mapping, persona
  synthesis, usability audit, UX-focused research synthesis, and retrospectives.
- `quality-assurance` includes bug report triage, regression testing, and test
  plan generation.
- `data-science` includes dataset search, data cleaning, EDA, feature
  engineering, model training, and model evaluation.
- `deep-research` includes deep research plus the standard research, planning,
  review, and retrospective flow.
- `software-factory` includes Factory Charter, Backlog Curation, Autonomous
  Sprint, CI Governance, and Factory Retrospective workflows for long-running
  autonomous software evolution.