Creates an ephemeral git worktree for isolated feature development

Lists all active worktrees with their metadata

Merges worktree to main and removes it. REQUIRES tests and build to pass first! Run run_e2e_tests and verify_build before calling this. Use force=true to bypass (NOT recommended).

Aborts worktree without merging. Use when feature is cancelled.

Runs E2E tests with Playwright. Tests MUST pass before merge. Supports retries and custom test paths.

Runs npm build and validates the output. Build MUST succeed before merge.

Generates a Playwright E2E test template for a feature. Every feature MUST have tests before merge.

Gets the latest test and build results from a worktree. Shows if the testing gate has been passed.

Starts a new feature with full workflow: creates worktree, sets up environment, initializes tracking. This is the recommended way to begin any development work.

Completes a feature: runs E2E tests, verifies build, merges to main, cleans up worktree. BLOCKS if tests or build fail. This is the safe way to merge - quality gates cannot be bypassed.

Rolls back a failed or unwanted feature: aborts worktree, cleans up branch, records reason. Use this when you need to abandon a feature without merging.

Gets the current status of all active workflows, including phase, steps, and progress.

Updates project documentation (CLAUDE.md, README.md) with information from the current workflow. Can auto-detect sections or target specific ones. Useful for keeping docs in sync with development.

Generates a detailed markdown report for a completed feature workflow. Includes test results, build status, timing, and git changes summary. Reports are saved to .smart-agent-workflow/reports/

Syncs CHANGELOG.md with workflow information. Follows Keep a Changelog format. Automatically detects version from package.json and categorizes changes based on feature type.

Save the current workflow context to memory. Captures decisions, learnings, and file changes for future sessions. Use this to persist important context before completing or rolling back a feature.

Restore context from a previous workflow. Retrieves decisions, learnings, files modified, and related memories. Use this to resume work on a feature or learn from past implementations.

Query the knowledge graph for relevant memories. Search by content, filter by type (decision, learning, error, etc.), tags, workflow, or file path. Returns sorted by importance and recency.

Save the current workflow state and reset health score. Creates a checkpoint before context is lost to compaction. Use when health is critical or before long operations. Returns health before/after and entries saved.

Get current context health metrics: health score, operations count, estimated tokens, session duration, and whether checkpoint is recommended. Use this to monitor context usage and anticipate compaction.