@champpaba/claude-agent-kit 2.0.1 → 2.1.0

package/PROJECT_STATUS.template.yml

@@ -0,0 +1,105 @@
+# PROJECT_STATUS.yml
+# Cross-session context for Claude - update after significant milestones
+# Optional: Remove this file if your project doesn't need cross-session tracking
+#
+# WHY this file exists:
+# - New Claude sessions lose context about infrastructure state, blockers, and priorities
+# - Reading multiple files (README, archived proposals, tasks.md) wastes tokens
+# - This single file provides quick context snapshot for AI sessions
+
+last_updated: "YYYY-MM-DD"
+
+# Optional settings
+_config:
+  stale_warning_days: 7  # Suggest /pstatus review if older than this
+
+# -------------------------------------------------------------------
+# CURRENT FOCUS
+# What phase is the project in? What's actively being worked on?
+# -------------------------------------------------------------------
+current_focus:
+  description: "Brief description of current project phase"
+  active_change: null  # change-id if OpenSpec change in progress, null if between changes
+
+# -------------------------------------------------------------------
+# COMPLETED CHANGES
+# Recently shipped work - helps Claude understand what's already done
+# -------------------------------------------------------------------
+completed_changes: []
+  # Example:
+  # - id: auth-system
+  #   date: "2025-11-30"
+  #   summary: "Login/logout, JWT tokens, protected routes"
+  # - id: infrastructure-cicd
+  #   date: "2025-11-28"
+  #   summary: "Docker, CI/CD pipeline, Cloudflare Tunnel"
+
+# -------------------------------------------------------------------
+# INFRASTRUCTURE STATUS
+# Current state of services - helps Claude understand what's running
+# -------------------------------------------------------------------
+infrastructure: {}
+  # Example structure (customize for your project):
+  #
+  # database:
+  #   status: healthy  # healthy | degraded | down | not_setup
+  #   notes: "PostgreSQL, 4 tables deployed"
+  #
+  # api:
+  #   status: healthy
+  #   notes: "6 endpoints, running on port 3000"
+  #
+  # cloudflare_tunnel:
+  #   status: running
+  #   waiting_for: domain  # null if fully operational
+  #   notes: "Tunnel active, pending domain configuration"
+  #
+  # Status values: healthy, degraded, down, not_setup, waiting
+
+# -------------------------------------------------------------------
+# BLOCKERS
+# External dependencies blocking progress
+# Claude will avoid suggesting work that's blocked
+# -------------------------------------------------------------------
+blockers: []
+  # Example:
+  # - id: domain-config
+  #   description: "Need domain for Cloudflare public routes"
+  #   blocks: [production-launch, ssl-setup]
+  #
+  # - id: stripe-api-key
+  #   description: "Waiting for Stripe test API key from finance team"
+  #   blocks: [payment-integration]
+
+# -------------------------------------------------------------------
+# NEXT PRIORITIES
+# What should be worked on next (with reasoning)
+# Helps Claude suggest appropriate next steps
+# -------------------------------------------------------------------
+next_priorities: []
+  # Example:
+  # - id: payment-integration
+  #   reason: "Revenue blocker - needed before launch"
+  #
+  # - id: user-profile
+  #   reason: "Dependency for RIASEC save feature"
+
+# -------------------------------------------------------------------
+# NOTES
+# Free-form context that doesn't fit above
+# -------------------------------------------------------------------
+notes: |
+  Add any additional context here.
+  Examples:
+  - Dev server running on localhost:3000
+  - Test with: curl http://localhost:3000/health
+  - Staging environment: https://staging.example.com
+
+# -------------------------------------------------------------------
+# REFERENCES (optional)
+# Quick links to important project files
+# -------------------------------------------------------------------
+references:
+  # roadmap: "docs/proposal_list.md"
+  # architecture: "openspec/specs/architecture.md"
+  # style_guide: "design-system/STYLE_GUIDE.md"