Skip to content

Status Definitions

Central reference for all status values used across NepWalk docs, tasks, and tests. All departments and AI tools must use these exact values.

Document Status

Used in frontmatter status: field of all docs (idea, PRD, SRS, user stories, roadmap, etc.)

Status Set by Meaning Next action
draft AI (on creation) Being worked on. Content may change. Author reviews, runs interviews, fills gaps.
review AI (via <dept>: publish) Ready for human review. PR opened. Human reviewer reads and approves or requests changes.
final Human reviewer Confirmed correct. Frozen. No more changes unless via change process (see SRS §3d). Downstream departments can use as input.

Rules:

  • AI can set draft and review. Only humans set final.
  • Downstream departments should only treat final documents as reliable inputs. draft and review documents can change.
  • Once final, changes require a separate PR (see SRS change process in management_skill.md §3d).

Task Track Status

Used in task_division docs for both AI work and human task columns.

Status Meaning
pending Not started.
in_progress Work has begun.
done Completed and verified.
skipped Explicitly skipped by user. skip_reason required. Logged in PROJECT_STATE.md.

Rules:

  • Both tracks (AI + human) must reach done before dependent tasks should start.
  • skipped requires explicit user confirmation — AI never assumes a skip.
  • Skipped items are visible in status reports across all departments.

Test / Acceptance Criteria Status

Used in acceptance_criteria docs for each test scenario.

Status Meaning
not tested No test has been run yet.
pass Test executed and passed.
fail Test executed and failed. Bug logged.
skipped Test explicitly skipped. Reason required. Flagged as ⚠️ not validated.

Interview Status

Used in state/drafts/<doc>_interview.json files.

Status Meaning
in_progress Interview rounds ongoing. Gaps remain.
complete All sections answered. Doc written.

PR Status

Used in dependency_map for tracking doc and code PRs.

Status Meaning
pending PR not yet created.
open PR created, awaiting review.
merged PR reviewed and merged.
closed PR closed without merging.

Member Invite Status

Used in trip_members table (SRS §8).

Status Meaning
active User is a confirmed trip member.
pending Invited by email but not yet registered or confirmed.