Appearance
Workflows Overview
A workflow is a Markdown file under workflows/ (in source) that defines an np:* slash-command. Each workflow body is a small shell script that wraps node np-tools.cjs <subcommand> calls, plus orchestration prose.
Planning
Set up the project, capture decisions, write plans.
| Command | What it does |
|---|---|
np:new-project | Greenfield init: PROJECT.md + REQUIREMENTS.md + roadmap.yaml + milestones/M001/ shell. Detects existing project and offers archive-then-init via Phase -1. |
np:archive-project | Move current .nubos-pilot/ project into archive/<slug>-<YYYYMMDD>/ with optional carry-over (status | do | list | read). Used by np:new-project Phase -1. |
np:new-milestone | Append a milestone (M<NNN>) to an existing project |
np:discuss-project | Adaptive project-level context interview (PROJECT.md body) |
np:discuss-phase <N> | Milestone-level decision interview → M<NNN>-CONTEXT.md |
np:research-phase <N> | Optional milestone-level research → M<NNN>-RESEARCH.md |
np:plan-phase <N> | Plan the entire milestone: slices + tasks. 2-iteration plan-checker loop. |
np:plan-phase <N> --repromote | Re-scaffold task files from existing slice plans without replanning |
np:agent-skills | Print the agent-skills config for a given subagent |
Execution
Wave-based execution: slices run serially, tasks parallel within each slice. One atomic commit per task.
| Command | What it does |
|---|---|
np:execute-phase <N> [--verify-work] | Execute milestone M<NNN> slice-by-slice. Pass --verify-work to auto-chain /np:verify-work <N> after finalize-milestone. |
np:verify-work <N> | Post-execution goal-backward verification → M<NNN>-VERIFICATION.md |
np:add-tests <N> | Persist VERIFICATION Pass-cases as node:test UAT files |
np:commit-task <M-S-T> | Atomic per-task commit via lib/git.cjs |
np:checkpoint | Per-task checkpoint CRUD (start/transition/touch/show) |
np:pause-work / np:resume-work | Explicit session handoff + crash-recovery classifier |
np:undo <N|M-S> | Revert every task commit of a milestone or slice via git revert |
np:undo-task <M-S-T> | Revert a single task commit and reset task status to pending |
np:reset-slice [<M-S-T>] | Discard in-flight task: restore working tree, drop checkpoint (no commit) |
np:skip / np:park / np:unpark | Task lifecycle state CRUD |
Review
Post-execution audits.
| Command | What it does |
|---|---|
np:validate-phase <N> | Nyquist coverage audit — every requirement has ≥1 direct test assertion |
np:close-project | Aggregate verification across every milestone; writes PROJECT-SUMMARY.md and sets roadmap.yaml.project_status = completed when no blockers remain. The single whole-project verification pass. |
Capture
Lightweight capture of work-in-flight ideas.
| Command | What it does |
|---|---|
np:add-todo | Capture a pending todo to .nubos-pilot/todos/pending/ |
np:note | Free-form note (project scope commits; --global writes to ~/.nubos-pilot/notes/) |
np:thread | Cross-session thread CRUD under .nubos-pilot/threads/ |
Utility
Routing, status, diagnostics.
| Command | What it does |
|---|---|
np:state | Print the current project state snapshot |
np:stats | Aggregated project stats (roadmap + STATE + git + metrics) |
np:dashboard | One-shot read-only view of milestones, slices, and task statuses (--json, --no-color) |
np:doctor | Install + layout integrity scan (--fix for auto-safe fixes) |
np:scan-codebase | Initial deep codebase inventory → .nubos-pilot/codebase/ |
np:update-docs | Refresh stale module docs after code changes |
np:session-report | Session report from metrics since .last-session |
np:help | List all commands grouped by category |
np:askuser | Capability-layer prompt wrapper |
np:commit | Atomic git commit wrapper with gitignore-guard |
np:config-get | Read value from .nubos-pilot/config.json |
np:generate-slug | Slugify text via lib/layout.cjs.slugify |
np:resolve-model | Resolve agent/tier to model alias or id |
np:metrics | Record JSONL metrics entry |