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 wrapping node np-tools.cjs <subcommand> calls plus orchestration prose.

The five categories below mirror the grouping in bin/np-tools/_commands.cjs — same names, same descriptions.

Planning

Set up the project, capture decisions, write plans.

Command	What it does
np:new-project	Greenfield init: PROJECT.md + REQUIREMENTS.md + roadmap + first phase dir
np:new-milestone	Append a milestone + first phase to an existing project
np:discuss-phase	Adaptive phase-context interview → CONTEXT.md
np:discuss-phase-power	Bulk gray-area question file-UI (power mode)
np:research-phase	Optional phase-level research → RESEARCH.md
np:plan-phase	Author PLAN.md with plan-checker verification loop
np:plan-milestone-gaps	Create corrective phases from audit gaps
np:agent-skills	Print the agent-skills config for a given subagent
np:plan-diff	Render a two-part PLAN.md diff (semantic + git)
np:ai-integration-phase	AI-SPEC generator with framework-selector + eval-planner
np:ui-phase	UI-SPEC generator with researcher + checker revision loop

Execution

Wave-based execution, atomic commits, lifecycle CRUD on tasks.

Command	What it does
np:execute-phase	Wave-based phase execution; spawns one executor per task
np:execute-plan	Single-plan execution (sub-case of execute-phase)
np:autonomous	In-session auto-advance loop (ADR-0001 — no daemon)
np:verify-work	Two-pass goal-backward verification → VERIFICATION.md
np:add-tests	Persist VERIFICATION Pass-cases as node:test UAT
np:commit-task	Atomic per-task commit via lib/git.cjs (D-03/D-25 enforced)
np:checkpoint	Per-task checkpoint CRUD (start/transition/touch/show)
np:pause-work	Stamp STATE.session.stopped_at + write resume file
np:resume-work	Classify session state from STATE + checkpoints
np:undo	Revert all task commits of a phase or plan via git revert
np:undo-task	Revert a single task commit and reset task status
np:reset-slice	Restore in-flight task working tree, no commit
np:skip	Mark task status skipped
np:park	Mark task status parked
np:unpark	Return a parked task to pending

Review

Audits and code review.

Command	What it does
np:code-review	Source-file review via np-code-reviewer → REVIEW.md
np:code-review-fix	Auto-fix REVIEW.md findings via np-code-fixer
np:review	Cross-AI peer review via 7-CLI fan-out
np:secure-phase	Threat-mitigation audit against PLAN.md threat_model
np:validate-phase	Nyquist validation gap-fill via np-nyquist-auditor
np:ui-review	Retroactive 6-pillar UI audit on a completed phase
np:eval-review	Retroactive eval-coverage audit on a completed phase

Capture

Lightweight capture of work-in-flight ideas.

Command	What it does
np:add-todo	Capture a pending todo + bump STATE count
np:note	Capture a free-form note (project default; --global writes to ~/.nubos-pilot/notes/)
np:add-backlog	Append backlog item 999.x to ROADMAP.md + scaffold phase dir
np:thread	Cross-session thread CRUD under .nubos-pilot/threads/

Utility

Routing, status, diagnostics.

Command	What it does
np:next	Print the next actionable step (six-rule gate)
np:dispatch	State-router: compute next action and Skill() to it
np:progress	Report % complete across phases and plans
np:state	Print the current project state snapshot
np:stats	Aggregated project stats (roadmap + STATE + git + metrics)
np:doctor	5-check install-integrity scan (--fix for auto-safe fixes)
np:queue	Unified queue across todos / backlog / UAT / unplanned phases
np:triage	Interactive per-item triage loop (promote / keep / drop)
np:cleanup	Archive completed milestones; collapse ROADMAP <details> block
np:session-report	Generate 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/phase.cjs.phaseSlug
np:phase	Phase utilities (next-decimal <base>)
np:resolve-model	Resolve agent/tier to model alias or id
np:metrics	Record JSONL metrics entry