@arvorco/relentless 0.6.1 → 0.8.0

package/.claude/skills/validators/scripts/validate-plan.sh

@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+# validate-plan.sh - Validate plan.md structure
+# Usage: validate-plan.sh <path-to-plan.md>
+#
+# Required structure:
+# - Title: # Technical Plan: [Feature Name]
+# - Technical Context section
+# - Constitution Compliance section
+# - Implementation Plan/Architecture
+# - Test Specifications section
+# - Quality Gates section
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+FILE="${1:-}"
+
+if [[ -z "$FILE" ]]; then
+  echo "Usage: validate-plan.sh <path-to-plan.md>"
+  exit 1
+fi
+
+if ! check_file "$FILE"; then
+  exit 1
+fi
+
+header "Validating Plan: $FILE"
+
+# Check for proper title
+info "Checking document structure..."
+
+if grep -qE "^# (Technical )?(Implementation )?Plan:" "$FILE" 2>/dev/null; then
+  FEATURE=$(grep -oE "^# .+Plan: .+" "$FILE" | head -1)
+  pass "Title found: $FEATURE"
+else
+  error "Missing title (expected: # Technical Plan: [Feature Name] or similar)"
+fi
+
+# Check for mandatory sections
+info "Checking mandatory sections..."
+
+# Technical Context/Overview
+if grep -qE "^## Technical Context|^## Context|^## Current State|^## Technical Overview|^## Overview" "$FILE" 2>/dev/null; then
+  pass "Technical Context/Overview section found"
+else
+  error "Missing Technical Context section (## Technical Context or ## Technical Overview)"
+fi
+
+# Constitution Compliance
+if grep -qE "^## Constitution Compliance|^## Compliance|^## Constitution" "$FILE" 2>/dev/null; then
+  pass "Constitution Compliance section found"
+else
+  error "Missing Constitution Compliance section (## Constitution Compliance)"
+fi
+
+# Check for principle references in compliance section
+PRINCIPLE_REFS=$(count_pattern "$FILE" "Principle [0-9]+")
+if [[ "$PRINCIPLE_REFS" -ge 1 ]]; then
+  pass "Found $PRINCIPLE_REFS constitution principle reference(s)"
+else
+  warning "No principle references found (should reference Principle 1, 2, etc.)"
+fi
+
+# Implementation Plan/Architecture
+if grep -qE "^## Implementation|^## Architecture|^## Design|^## Approach" "$FILE" 2>/dev/null; then
+  pass "Implementation/Architecture section found"
+else
+  error "Missing Implementation section (## Implementation Plan or ## Architecture)"
+fi
+
+# Test Specifications
+if grep -qE "^## Test|^## Testing|^## TDD" "$FILE" 2>/dev/null; then
+  pass "Test Specifications section found"
+else
+  error "Missing Test section (## Test Specifications or ## Testing Strategy)"
+fi
+
+# Quality Gates (optional - quality checks may be documented elsewhere)
+if grep -qE "^## Quality|^## Gates|^## Validation|^### Quality" "$FILE" 2>/dev/null; then
+  pass "Quality Gates section found"
+else
+  warning "No explicit Quality Gates section (## Quality Gates)"
+fi
+
+# Check test strategy content
+info "Checking test coverage..."
+
+# Unit tests
+if grep -qiE "unit test|unit-test" "$FILE" 2>/dev/null; then
+  pass "Unit testing mentioned"
+else
+  warning "No unit testing strategy documented"
+fi
+
+# Integration tests
+if grep -qiE "integration test|integration-test|e2e|end-to-end" "$FILE" 2>/dev/null; then
+  pass "Integration/E2E testing mentioned"
+else
+  warning "No integration testing strategy documented"
+fi
+
+# Check quality gates content
+info "Checking quality requirements..."
+
+# Typecheck
+if grep -qiE "typecheck|type-check|typescript" "$FILE" 2>/dev/null; then
+  pass "Type checking documented"
+else
+  warning "No typecheck requirements documented"
+fi
+
+# Lint
+if grep -qiE "lint|eslint" "$FILE" 2>/dev/null; then
+  pass "Linting documented"
+else
+  warning "No linting requirements documented"
+fi
+
+# Check for optional but recommended sections
+info "Checking optional sections..."
+
+check_section_warn "$FILE" "^## Risk|^## Risks" "Risk Assessment section"
+check_section_warn "$FILE" "^## Assumptions|^## Constraints" "Assumptions/Constraints section"
+check_section_warn "$FILE" "^## Dependencies" "Dependencies section"
+check_section_warn "$FILE" "^## Timeline|^## Milestones" "Timeline/Milestones section"
+
+# Check for file change documentation
+info "Checking implementation guidance..."
+
+FILE_CHANGES=$(count_pattern "$FILE" "\.ts|\.tsx|\.js|\.jsx|\.md|\.json|\.sh")
+if [[ "$FILE_CHANGES" -ge 3 ]]; then
+  pass "File references found ($FILE_CHANGES files mentioned)"
+else
+  warning "Few file references found (plan should list files to create/modify)"
+fi
+
+# Check for code examples
+CODE_BLOCKS=$(grep -c '```' "$FILE" 2>/dev/null || echo "0")
+CODE_BLOCKS=$((CODE_BLOCKS / 2))
+if [[ "$CODE_BLOCKS" -ge 1 ]]; then
+  pass "Found $CODE_BLOCKS code block(s)"
+else
+  warning "No code examples found (recommended for technical plans)"
+fi
+
+# Check spec reference
+info "Checking cross-references..."
+
+if grep -qE "spec\.md|specification" "$FILE" 2>/dev/null; then
+  pass "References spec.md"
+else
+  warning "No reference to spec.md found"
+fi
+
+# Check for placeholders
+info "Checking for unfilled placeholders..."
+check_no_placeholders "$FILE"
+
+# Print summary
+print_summary "plan.md"
+exit $?

package/.claude/skills/validators/scripts/validate-prompt.sh

@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# validate-prompt.sh - Validate prompt.md structure
+# Usage: validate-prompt.sh <path-to-prompt.md>
+#
+# Required structure:
+# - Title: # Relentless Agent Instructions or similar
+# - Quality Gates section with bash commands
+# - TDD Workflow section
+# - Progress Report Format section
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+FILE="${1:-}"
+
+if [[ -z "$FILE" ]]; then
+  echo "Usage: validate-prompt.sh <path-to-prompt.md>"
+  exit 1
+fi
+
+if ! check_file "$FILE"; then
+  exit 1
+fi
+
+header "Validating Prompt: $FILE"
+
+# Check for title
+info "Checking document structure..."
+
+if grep -qE "^# .*Agent.*Instructions|^# .*Prompt|^# Relentless" "$FILE" 2>/dev/null; then
+  TITLE=$(grep -oE "^# .*" "$FILE" | head -1)
+  pass "Title found: $TITLE"
+else
+  error "Missing prompt title (expected: # Relentless Agent Instructions or similar)"
+fi
+
+# Check for Quality Gates section
+info "Checking required sections..."
+
+if grep -qE "^##+ .*Quality Gates|^##+ Quality Commands" "$FILE" 2>/dev/null; then
+  pass "Quality Gates section found"
+else
+  error "Missing Quality Gates section (expected: ## Quality Gates)"
+fi
+
+# Check for actual quality commands (bash code blocks)
+BASH_BLOCKS=$(count_pattern "$FILE" '```bash')
+if [[ "$BASH_BLOCKS" -ge 1 ]]; then
+  pass "Found $BASH_BLOCKS bash code block(s) with quality commands"
+else
+  warning "No bash code blocks found (expected quality commands in bash blocks)"
+fi
+
+# Check for TDD Workflow section
+if grep -qE "^##+ TDD|^##+ Test.Driven" "$FILE" 2>/dev/null; then
+  pass "TDD Workflow section found"
+else
+  error "Missing TDD Workflow section (expected: ## TDD Workflow)"
+fi
+
+# Check for Progress Report section
+if grep -qE "^##+ Progress|progress.txt" "$FILE" 2>/dev/null; then
+  pass "Progress Report section found"
+else
+  warning "Missing Progress Report section"
+fi
+
+# Check for One Story rule
+if grep -qE "ONE Story|one story|single story" "$FILE" 2>/dev/null; then
+  pass "One Story Per Iteration rule found"
+else
+  warning "Missing One Story Per Iteration guidance"
+fi
+
+# Check for Stop Condition / completion signal
+if grep -qE "Stop Condition|COMPLETE|promise" "$FILE" 2>/dev/null; then
+  pass "Stop condition / completion signal documented"
+else
+  warning "Missing stop condition or completion signal documentation"
+fi
+
+# Check for version metadata
+info "Checking metadata..."
+
+if grep -qE "Template Version|Version:|Generated:" "$FILE" 2>/dev/null; then
+  VERSION=$(grep -oE "[0-9]+\.[0-9]+\.[0-9]+" "$FILE" | head -1 || echo "unknown")
+  pass "Version/metadata found: $VERSION"
+else
+  warning "No version metadata found"
+fi
+
+# Check for placeholders
+info "Checking for unfilled placeholders..."
+check_no_placeholders "$FILE"
+
+# Check for common quality commands
+info "Checking quality command patterns..."
+
+TYPECHECK_FOUND=$(grep -c "typecheck\|tsc" "$FILE" 2>/dev/null) || true
+LINT_FOUND=$(grep -c "lint\|eslint\|biome" "$FILE" 2>/dev/null) || true
+TEST_FOUND=$(grep -c "test\|vitest\|jest\|bun test" "$FILE" 2>/dev/null) || true
+
+if [[ "$TYPECHECK_FOUND" -ge 1 ]]; then
+  pass "Typecheck command reference found"
+else
+  warning "No typecheck command mentioned"
+fi
+
+if [[ "$LINT_FOUND" -ge 1 ]]; then
+  pass "Lint command reference found"
+else
+  warning "No lint command mentioned"
+fi
+
+if [[ "$TEST_FOUND" -ge 1 ]]; then
+  pass "Test command reference found"
+else
+  warning "No test command mentioned"
+fi
+
+# Print summary
+print_summary "prompt.md"
+exit $?

package/.claude/skills/validators/scripts/validate-spec.sh

@@ -0,0 +1,214 @@
+#!/usr/bin/env bash
+# validate-spec.sh - Validate spec.md structure
+# Usage: validate-spec.sh <path-to-spec.md>
+#
+# Required structure:
+# - Title: # Feature Specification: [Feature Name]
+# - User Scenarios & Testing section (mandatory)
+# - User stories with priorities (P1, P2, P3)
+# - Given/When/Then acceptance scenarios
+# - Functional Requirements section (mandatory) with FR-XXX items
+# - Test Strategy section (mandatory)
+# - Success Criteria section (mandatory)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+FILE="${1:-}"
+
+if [[ -z "$FILE" ]]; then
+  echo "Usage: validate-spec.sh <path-to-spec.md>"
+  exit 1
+fi
+
+if ! check_file "$FILE"; then
+  exit 1
+fi
+
+header "Validating Spec: $FILE"
+
+# Check for proper title
+info "Checking document structure..."
+
+if grep -qE "^# Feature Specification:|^# Specification:|^# Spec:" "$FILE" 2>/dev/null; then
+  FEATURE=$(grep -oE "^# (Feature )?Spec(ification)?: .+" "$FILE" | sed 's/^# \(Feature \)\?Spec\(ification\)\?: //')
+  pass "Title found: $FEATURE"
+else
+  error "Missing title (expected: # Feature Specification: [Feature Name])"
+fi
+
+# Check for Feature Branch
+if grep -qE "\*\*Feature Branch\*\*:|Feature Branch:" "$FILE" 2>/dev/null; then
+  pass "Feature branch documented"
+else
+  warning "No feature branch documented (recommended: **Feature Branch**: \`feature-name\`)"
+fi
+
+# Check for Routing Preference
+if grep -qE "\*\*Routing Preference\*\*:|Routing Preference:" "$FILE" 2>/dev/null; then
+  pass "Routing preference documented"
+else
+  warning "No routing preference documented (affects PRD generation)"
+fi
+
+# Check mandatory sections
+info "Checking mandatory sections..."
+
+# User Scenarios & Testing
+if grep -qE "^## User Scenarios|^## Scenarios|^## User Stories" "$FILE" 2>/dev/null; then
+  pass "User Scenarios section found"
+else
+  error "Missing User Scenarios section (## User Scenarios & Testing)"
+fi
+
+# Functional Requirements
+if grep -qE "^## Requirements|^## Functional Requirements|^### Functional Requirements" "$FILE" 2>/dev/null; then
+  pass "Requirements section found"
+else
+  error "Missing Requirements section (## Requirements)"
+fi
+
+# Test Strategy (optional - may be in plan.md instead)
+if grep -qE "^## Test Strategy|^## Testing Strategy|^## Test Plan" "$FILE" 2>/dev/null; then
+  pass "Test Strategy section found"
+else
+  warning "No Test Strategy section (may be in plan.md instead)"
+fi
+
+# Success Criteria
+if grep -qE "^## Success Criteria|^## Acceptance Criteria|^## Definition of Done" "$FILE" 2>/dev/null; then
+  pass "Success Criteria section found"
+else
+  error "Missing Success Criteria section (## Success Criteria)"
+fi
+
+# Check user stories
+info "Checking user story quality..."
+
+# Count user stories
+US_HEADING_COUNT=$(count_pattern "$FILE" "^### User Story [0-9]+")
+if [[ "$US_HEADING_COUNT" -ge 1 ]]; then
+  pass "Found $US_HEADING_COUNT user story section(s)"
+else
+  error "No user story sections found (expected: ### User Story 1 - Title)"
+fi
+
+# Check for priorities
+PRIORITY_COUNT=$(count_pattern "$FILE" "\(Priority: P[0-9]+\)|\*\*Priority\*\*: P[0-9]+")
+if [[ "$PRIORITY_COUNT" -ge 1 ]]; then
+  pass "Found $PRIORITY_COUNT priority assignment(s)"
+else
+  error "No priorities found (user stories need Priority: P1, P2, P3, etc.)"
+fi
+
+# Check for P1 priority specifically
+if grep -qE "Priority: P1|Priority\*\*: P1" "$FILE" 2>/dev/null; then
+  pass "Has P1 (highest priority) story"
+else
+  warning "No P1 priority story found (at least one story should be P1)"
+fi
+
+# Check TDD format (Given/When/Then)
+info "Checking TDD compliance..."
+
+GIVEN_COUNT=$(count_pattern "$FILE" "\*\*Given\*\*|Given ")
+WHEN_COUNT=$(count_pattern "$FILE" "\*\*When\*\*|When ")
+THEN_COUNT=$(count_pattern "$FILE" "\*\*Then\*\*|Then ")
+
+if [[ "$GIVEN_COUNT" -ge 1 && "$WHEN_COUNT" -ge 1 && "$THEN_COUNT" -ge 1 ]]; then
+  pass "Given/When/Then format used ($GIVEN_COUNT/$WHEN_COUNT/$THEN_COUNT)"
+else
+  error "Missing Given/When/Then acceptance scenarios (TDD requirement)"
+fi
+
+# Check for acceptance scenarios heading
+if grep -qE "\*\*Acceptance Scenarios\*\*:|^#### Acceptance" "$FILE" 2>/dev/null; then
+  pass "Acceptance Scenarios documented"
+else
+  warning "No explicit 'Acceptance Scenarios' heading found"
+fi
+
+# Check functional requirements
+info "Checking functional requirements..."
+
+FR_COUNT=$(count_pattern "$FILE" "\*\*FR-[0-9]+\*\*:|FR-[0-9]+:")
+if [[ "$FR_COUNT" -ge 3 ]]; then
+  pass "Found $FR_COUNT functional requirement(s)"
+else
+  error "Insufficient functional requirements (expected at least 3 FR-XXX items)"
+fi
+
+# Check for MUST requirements
+MUST_COUNT=$(count_pattern "$FILE" "System MUST|MUST")
+if [[ "$MUST_COUNT" -ge 1 ]]; then
+  pass "Found $MUST_COUNT MUST requirement(s)"
+else
+  warning "No MUST requirements found (FRs should use 'System MUST...')"
+fi
+
+# Check test strategy content
+info "Checking test strategy quality..."
+
+# Unit tests
+if grep -qiE "^### Unit Test|unit test" "$FILE" 2>/dev/null; then
+  pass "Unit test approach documented"
+else
+  warning "No unit test approach documented"
+fi
+
+# Integration tests
+if grep -qiE "^### Integration Test|integration test" "$FILE" 2>/dev/null; then
+  pass "Integration test approach documented"
+else
+  warning "No integration test approach documented"
+fi
+
+# Edge cases
+if grep -qiE "^### Edge Case|edge case" "$FILE" 2>/dev/null; then
+  pass "Edge case tests documented"
+else
+  warning "No edge case tests documented"
+fi
+
+# Check success criteria
+info "Checking success criteria quality..."
+
+SC_COUNT=$(count_pattern "$FILE" "\*\*SC-[0-9]+\*\*:|SC-[0-9]+:")
+if [[ "$SC_COUNT" -ge 2 ]]; then
+  pass "Found $SC_COUNT success criteria"
+else
+  warning "Few success criteria found (recommended at least 2 SC-XXX items)"
+fi
+
+# Check for measurable metrics
+if grep -qiE "[0-9]+%|[0-9]+ seconds|[0-9]+ minutes|[0-9]+ users" "$FILE" 2>/dev/null; then
+  pass "Measurable metrics found in criteria"
+else
+  warning "No measurable metrics found (success criteria should be quantifiable)"
+fi
+
+# Check for optional sections
+info "Checking optional sections..."
+
+check_section_warn "$FILE" "^### Edge Cases|^## Edge Cases" "Edge Cases section"
+check_section_warn "$FILE" "^### Key Entities|^## Key Entities|^## Data Model" "Key Entities/Data Model section"
+check_section_warn "$FILE" "^### Test Data|test data" "Test Data Requirements"
+
+# Check for placeholders
+info "Checking for unfilled placeholders..."
+check_no_placeholders "$FILE"
+
+# Check for common issues
+info "Checking for common issues..."
+
+# Check for [NEEDS CLARIFICATION] tags
+CLARIFICATION_COUNT=$(count_pattern "$FILE" "\[NEEDS CLARIFICATION")
+if [[ "$CLARIFICATION_COUNT" -gt 0 ]]; then
+  warning "Found $CLARIFICATION_COUNT unresolved [NEEDS CLARIFICATION] tag(s)"
+fi
+
+# Print summary
+print_summary "spec.md"
+exit $?

package/.claude/skills/validators/scripts/validate-tasks.sh

@@ -0,0 +1,179 @@
+#!/usr/bin/env bash
+# validate-tasks.sh - Validate tasks.md structure
+# Usage: validate-tasks.sh <path-to-tasks.md>
+#
+# Required structure:
+# - Title: # Implementation Tasks: [Feature Name]
+# - At least one Phase section
+# - User stories with [US-XXX] tags
+# - Tasks under each user story
+# - Complexity classifications
+# - Dependencies properly formatted
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+FILE="${1:-}"
+
+if [[ -z "$FILE" ]]; then
+  echo "Usage: validate-tasks.sh <path-to-tasks.md>"
+  exit 1
+fi
+
+if ! check_file "$FILE"; then
+  exit 1
+fi
+
+header "Validating Tasks: $FILE"
+
+# Check for proper title
+info "Checking document structure..."
+
+if grep -qE "^# (Implementation Tasks|User Stories):" "$FILE" 2>/dev/null; then
+  FEATURE=$(grep -oE "^# (Implementation Tasks|User Stories): .+" "$FILE" | head -1)
+  pass "Title found: $FEATURE"
+else
+  error "Missing title (expected: # Implementation Tasks: [Feature Name] or # User Stories: [Feature Name])"
+fi
+
+# Check for at least one Phase section
+PHASE_COUNT=$(count_pattern "$FILE" "^## Phase [0-9]+")
+if [[ "$PHASE_COUNT" -ge 1 ]]; then
+  pass "Found $PHASE_COUNT Phase section(s)"
+else
+  error "No Phase sections found (expected: ## Phase 1: ..., ## Phase 2: ..., etc.)"
+fi
+
+# Check for user stories
+info "Checking user stories..."
+
+# Support both [US-XXX] and US-XXX: formats
+US_COUNT=$(count_pattern "$FILE" "\[US-[0-9]+\]|^### US-[0-9]+:")
+if [[ "$US_COUNT" -ge 1 ]]; then
+  pass "Found $US_COUNT user story reference(s)"
+else
+  error "No user story tags found (expected: [US-001] or ### US-001:)"
+fi
+
+# Check for user story headings - both formats
+US_HEADING_COUNT_BRACKET=$(count_pattern "$FILE" "^### \[US-[0-9]+\]")
+US_HEADING_COUNT_COLON=$(count_pattern "$FILE" "^### US-[0-9]+:")
+US_HEADING_COUNT=$((US_HEADING_COUNT_BRACKET + US_HEADING_COUNT_COLON))
+if [[ "$US_HEADING_COUNT" -ge 1 ]]; then
+  pass "Found $US_HEADING_COUNT user story heading(s)"
+else
+  error "No user story headings found (expected: ### [US-001] Title or ### US-001: Title)"
+fi
+
+# Check for complexity classifications
+info "Checking metadata..."
+
+COMPLEXITY_COUNT=$(count_pattern "$FILE" "\*\*Complexity\*\*:|Complexity:")
+if [[ "$COMPLEXITY_COUNT" -ge 1 ]]; then
+  pass "Found $COMPLEXITY_COUNT complexity classification(s)"
+else
+  warning "No complexity classifications found (recommended: **Complexity**: simple|medium|complex|expert)"
+fi
+
+# Check that complexities are valid values
+if grep -qE "Complexity\*?\*?:\s*(simple|medium|complex|expert)" "$FILE" 2>/dev/null; then
+  pass "Complexity values are valid (simple/medium/complex/expert)"
+else
+  if [[ "$COMPLEXITY_COUNT" -ge 1 ]]; then
+    warning "Some complexity values may be invalid (expected: simple, medium, complex, expert)"
+  fi
+fi
+
+# Check for Dependencies section or references
+DEP_COUNT=$(count_pattern "$FILE" "\*\*Dependencies\*\*:|Depends on:|←")
+if [[ "$DEP_COUNT" -ge 1 ]]; then
+  pass "Found $DEP_COUNT dependency reference(s)"
+else
+  warning "No dependencies documented (use **Dependencies**: or ← symbol)"
+fi
+
+# Check for task checkboxes
+info "Checking task structure..."
+
+TASK_COUNT=$(count_pattern "$FILE" "^- \[ \]|^  - \[ \]|^    - \[ \]")
+if [[ "$TASK_COUNT" -ge 1 ]]; then
+  pass "Found $TASK_COUNT task checkbox(es)"
+else
+  error "No task checkboxes found (expected: - [ ] Task description)"
+fi
+
+# Check for acceptance criteria or test mentions
+CRITERIA_COUNT=$(count_pattern "$FILE" "\*\*Acceptance\*\*|\*\*Test\*\*|acceptance criteria|Given.*When.*Then")
+if [[ "$CRITERIA_COUNT" -ge 1 ]]; then
+  pass "Found $CRITERIA_COUNT acceptance/test reference(s)"
+else
+  warning "No acceptance criteria found (recommended for testability)"
+fi
+
+# Check for Files to Create/Modify sections
+info "Checking implementation guidance..."
+
+FILES_SECTION=$(count_pattern "$FILE" "\*\*Files to|Files to Create|Files to Modify")
+if [[ "$FILES_SECTION" -ge 1 ]]; then
+  pass "Found file change documentation"
+else
+  warning "No 'Files to Create/Modify' documentation (recommended)"
+fi
+
+# Check for PRD conversion compatibility
+info "Checking PRD conversion compatibility..."
+
+# User stories need to have clear boundaries for prd.json conversion
+# Looking for structured format: ### [US-XXX] Title or ### US-XXX: Title
+if grep -qE "^### (\[US-[0-9]+\]|US-[0-9]+:)" "$FILE" 2>/dev/null; then
+  pass "User stories have PRD-convertible format"
+else
+  error "User story format not PRD-convertible (need: ### [US-XXX] Title or ### US-XXX: Title)"
+fi
+
+# Check routing preference exists for prd.json
+if grep -qE "Routing Preference|routing preference|Mode:|mode:" "$FILE" 2>/dev/null; then
+  pass "Routing preference documented"
+else
+  warning "No routing preference found (will use defaults in prd.json)"
+fi
+
+# Check for placeholders
+info "Checking for unfilled placeholders..."
+check_no_placeholders "$FILE"
+
+# Check for common issues
+info "Checking for common issues..."
+
+# Check for duplicate US numbers (handles both [US-XXX] and US-XXX: formats)
+DUPLICATE_US=$(grep -oE "\[US-[0-9]+\]|### US-[0-9]+:" "$FILE" 2>/dev/null | grep -oE "US-[0-9]+" | sort | uniq -d)
+if [[ -z "$DUPLICATE_US" ]]; then
+  pass "No duplicate user story IDs"
+else
+  warning "Duplicate user story IDs found: $DUPLICATE_US"
+fi
+
+# Check US numbers are sequential (just a warning)
+US_NUMBERS=$(grep -oE "US-[0-9]+" "$FILE" 2>/dev/null | grep -oE "[0-9]+" | sort -n | uniq)
+EXPECTED_SEQ=1
+SEQ_OK=true
+for num in $US_NUMBERS; do
+  # Use 10# to force base 10 (avoid octal interpretation of 008, 009)
+  if [[ "$((10#$num))" -ne "$EXPECTED_SEQ" ]]; then
+    SEQ_OK=false
+    break
+  fi
+  EXPECTED_SEQ=$((EXPECTED_SEQ + 1))
+done
+
+if [[ "$SEQ_OK" == "true" ]]; then
+  pass "User story IDs are sequential"
+else
+  warning "User story IDs are not sequential (gaps may exist)"
+fi
+
+# Print summary
+print_summary "tasks.md"
+exit $?