Kjell Tore Guttormsen
f460814fe9
Pre-trekexecute snapshot of in-progress CLAUDE.md/SKILL.md edits and extracted docs/ files. Captured as one commit so /trekexecute claude-design can run against a clean working tree. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
85 lines
5.3 KiB
Markdown
85 lines
5.3 KiB
Markdown
# Voyage — Command flag reference
|
|
|
|
Per-command flag tables, imported from `CLAUDE.md` via pointer.
|
|
|
|
## /trekbrief modes
|
|
|
|
| Flag | Behavior |
|
|
|------|----------|
|
|
| _(default)_ | Dynamic interview until quality gates pass → brief.md with research plan |
|
|
| `--quick` | Compact start; still escalates if required sections are weak or the brief-review gate fails → brief.md with research plan |
|
|
| `--gates {open\|closed\|adaptive}` | (v3.4.0) Autonomy-checkpoint policy. Default `adaptive` |
|
|
| `--profile <name>` | (v4.1.0) Model profile: `economy` / `balanced` / `premium` / `<custom>`. Sets `phase_models` for the brief phase. See `## Profile system` in `docs/operations.md`. |
|
|
|
|
Always interactive. Phase 3 is a section-driven completeness loop (no hard cap on question count); Phase 4 runs a `brief-reviewer` stop-gate with max 3 review iterations. After writing the brief, asks the user to choose manual (print commands) or auto (Claude runs research + plan in foreground).
|
|
|
|
## /trekresearch modes
|
|
|
|
| Flag | Behavior |
|
|
|------|----------|
|
|
| _(default)_ | Interview + research (local + external) + synthesis + brief (foreground) |
|
|
| `--project <dir>` | Write brief to `{dir}/research/{NN}-{slug}.md` (auto-incremented) |
|
|
| `--quick` | Interview (short) + inline research (no agent swarm) |
|
|
| `--local` | Only codebase analysis agents (skip external + Gemini) |
|
|
| `--external` | Only external research agents (skip codebase analysis) |
|
|
| `--fg` | No-op alias (foreground is default since v2.4.0) |
|
|
| `--gates {open\|closed\|adaptive}` | (v3.4.0) Autonomy-checkpoint policy. Default `adaptive` |
|
|
| `--profile <name>` | (v4.1.0) Model profile for the research phase. |
|
|
|
|
Flags combine: `--project <dir> --local`, `--external --quick`.
|
|
|
|
## /trekplan modes
|
|
|
|
| Flag | Behavior |
|
|
|------|----------|
|
|
| `--project <dir>` | **Required path A** — read `{dir}/brief.md`, auto-discover `{dir}/research/*.md`, write `{dir}/plan.md` |
|
|
| `--brief <path>` | **Required path B** — plan from a specific brief file; write to `.claude/plans/trekplan-{date}-{slug}.md` |
|
|
| `--research <brief> [brief2]` | Enrich with extra research briefs beyond what is in `{project_dir}/research/` |
|
|
| `--fg` | No-op alias (foreground is default since v2.4.0) |
|
|
| `--quick` | Plan directly (no agent swarm) |
|
|
| `--export <pr\|issue\|markdown\|headless> <plan>` | Generate shareable output from existing plan |
|
|
| `--decompose <plan>` | Split plan into self-contained headless sessions |
|
|
| `--gates {open\|closed\|adaptive}` | (v3.4.0) Autonomy-checkpoint policy. Default `adaptive` |
|
|
| `--profile <name>` | (v4.1.0) Model profile for the plan phase (and others, since plan emits `profile:` to plan.md frontmatter). |
|
|
|
|
**Breaking change (v2.0):** one of `--brief` or `--project` is required. There is no interview inside `/trekplan`. The `--spec` flag has been removed — use `/trekbrief` to produce a brief instead.
|
|
|
|
If `{project_dir}/architecture/overview.md` exists (typically produced by an opt-in upstream architect plugin, not bundled), the plan command auto-discovers it and treats `cc_features_proposed` as priors. Missing file is fine — discovery is additive, not required.
|
|
|
|
## /trekexecute modes
|
|
|
|
| Flag | Behavior |
|
|
|------|----------|
|
|
| _(default)_ | Execute plan — auto-detects Execution Strategy for multi-session |
|
|
| `--project <dir>` | Read `{dir}/plan.md`, write `{dir}/progress.json` |
|
|
| `--resume` | Resume from last progress checkpoint |
|
|
| `--dry-run` | Validate plan structure without executing |
|
|
| `--validate` | Schema-only check — parse steps + manifests, report `READY \| FAIL`, no execution |
|
|
| `--step N` | Execute only step N |
|
|
| `--fg` | Force foreground — run all steps sequentially, ignore Execution Strategy |
|
|
| `--session N` | Execute only session N from plan's Execution Strategy |
|
|
| `--gates {open\|closed\|adaptive}` | (v3.4.0) Autonomy-checkpoint policy. Default `adaptive` |
|
|
| `--profile <name>` | (v4.1.0) Model profile for the execute phase. Inherited from plan.md frontmatter `profile:` if present. |
|
|
|
|
## /trekreview modes
|
|
|
|
| Flag | Behavior |
|
|
|------|----------|
|
|
| _(default)_ | Run brief-conformance + code-correctness reviewers in parallel, coordinator dedup + verdict, write `{project_dir}/review.md` |
|
|
| `--project <dir>` | **Required.** Path to trekplan project folder containing `brief.md`. Review is written to `{dir}/review.md` |
|
|
| `--since <ref>` | Override "before" SHA for the diff range. Validated via `git rev-parse --verify` |
|
|
| `--quick` | Skip brief-conformance reviewer; skip coordinator's reasonableness filter — fast correctness-only pass |
|
|
| `--validate` | Schema-only check on existing `{dir}/review.md`. No LLM calls |
|
|
| `--dry-run` | Print discovered scope + triage map; skip writes |
|
|
| `--fg` | No-op alias (foreground is default) |
|
|
| `--profile <name>` | (v4.1.0) Model profile for the review phase. |
|
|
|
|
## /trekcontinue modes
|
|
|
|
| Flag | Behavior |
|
|
|------|----------|
|
|
| _(default)_ | Auto-discover active project's `.session-state.local.json` and resume |
|
|
| `<project-dir>` | Resume the next session of an explicit project directory |
|
|
| `--profile <name>` | (v4.1.0) Model profile for the resumed session. Inherited from the previous session's plan.md frontmatter when absent. |
|
|
|
|
The triage gate is deterministic — path-pattern classifier produces `{file → deep-review|summary-only|skip}`. Hard refuse-with-suggestion above 100 files / 100K diff tokens.
|