Project Timeline CLI

Manage project timeline with CLI: venv/bin/python SCRIPTS/timeline_cli.py (use as timeline)

When to Load This Skill

• Starting a new work session (get next task)
• Completing any checklist item (mark complete)
• Unsure what to work on next
• Checking progress

CLI Commands

Get Next Task

# What should I work on?
venv/bin/python SCRIPTS/timeline_cli.py next

# Next task in week 1
venv/bin/python SCRIPTS/timeline_cli.py next --week 1

# Next task in test section
venv/bin/python SCRIPTS/timeline_cli.py next --section test

# JSON output
venv/bin/python SCRIPTS/timeline_cli.py next --json

Mark Complete

# Mark done + automatic git commit
venv/bin/python SCRIPTS/timeline_cli.py complete w1-test-003

# Mark done without commit
venv/bin/python SCRIPTS/timeline_cli.py complete w1-test-003 --no-commit

# Custom commit message
venv/bin/python SCRIPTS/timeline_cli.py complete w1-test-003 -m "Custom message"

Check Status

# Current week progress
venv/bin/python SCRIPTS/timeline_cli.py status

# JSON output
venv/bin/python SCRIPTS/timeline_cli.py status --json

Find Tasks

# All pending tasks
venv/bin/python SCRIPTS/timeline_cli.py find --status pending

# Week 1 tasks
venv/bin/python SCRIPTS/timeline_cli.py find --week 1

# Completed tasks in test section
venv/bin/python SCRIPTS/timeline_cli.py find --status completed --section test

# First 5 tasks
venv/bin/python SCRIPTS/timeline_cli.py find --limit 5

Workflow

1. Start Session: timeline next → Get next pending task
2. Do Work: Implement/test/document
3. Complete: timeline complete TASK_ID → Updates JSON + git commit
4. Push: git push (if configured)

Core Principles

Priority 1: Complete the Framework

Establish baseline → Research dependencies → Complete framework logic

Focus on building complete system first:

• ✅ All commands exist and work
• ✅ All wrappers exist and work
• ✅ All skills exist
• ✅ State machine works
• ✅ Integration works end-to-end

DO NOT get distracted by:

• Testing multiple hypotheses (1-2 validates system)
• Optimizing performance (works first, fast second)
• Adding features not in checklist
• Extensive documentation (minimal docs, focus on code)

Priority 2: Validate the Framework

Validate logic paths → Test robustness → Calibrate thresholds

Only after Priority 1 complete:

• Test decision framework with diverse scenarios
• Measure false positive/negative rates
• Calibrate thresholds
• Validate reliability

Robustness is meaningless without completeness.

Authoritative Documentation (Source of Truth)

When confused about workflow, phases, or decisions:

• Read: PROJECT_DOCUMENTATION/autonomous_decision_framework.md
• Contains: 5-phase workflow, decision thresholds, routing logic

When confused about architecture or how components fit:

• Read: PREVIOUS_WORK/PROJECT_DOCUMENTATION/autonomous_workflow_architecture.md
• Contains: Complete system architecture, state machine, integration patterns

Never guess. Always research first. Use authoritative docs as source of truth.

CLI Help

Use --help for command details:

venv/bin/python SCRIPTS/timeline_cli.py --help
venv/bin/python SCRIPTS/timeline_cli.py next --help
venv/bin/python SCRIPTS/timeline_cli.py complete --help

Do not read timeline_cli.py source code. Use --help for usage.

Context Savings: 60 lines (vs 631 lines in old skill) = 90% reduction

Progressive Disclosure: Load only what you need (next task, not entire timeline)

Trifecta: CLI works for humans, teams, AND agents