Skip to content

.claude.md

Latest commit

 

History

History
67 lines (49 loc) · 2.13 KB

.claude.md

File metadata and controls

67 lines (49 loc) · 2.13 KB

Vindicta Platform - Claude Guidelines

Platform Identity

The Vindicta Platform is a 26-repository tactical gaming ecosystem. You are operating within a monorepo containing all platform components.

Key Constraints

  1. Economic: GCP Free Tier only, AI via "Gas Tank" model
  2. Spec-Driven: No code without .specify/ specification
  3. Async-First: All I/O must be async/await
  4. Windows-Only: PowerShell/Batch for all tooling
  5. MCP-First: Use MCP servers, not CLI commands

Tooling Rules

  • Python: Use uv for package management
  • Frontend: Use npm/Vite
  • GitHub: Use GitHub MCP server, not gh CLI
  • GCP: Use Cloud Run MCP server, not gcloud CLI
  • Firebase: Use Firebase MCP server, not firebase CLI

Workflow

Follow the Spec-Kit lifecycle:

  1. specify → Define feature in .specify/
  2. clarify → Ask targeted questions
  3. plan → Create implementation plan
  4. tasks → Generate actionable task list
  5. implement → Red-Green-Refactor commits
  6. analyze → Cross-artifact consistency check

Git Discipline

  • Always branch from latest main
  • Push immediately to lock branch
  • Minimum 2 commits: RED (failing test) → GREEN (passing)
  • Max 1,000 lines per PR
  • Reference .specify/ specs in PR descriptions

Quality Gates

  • 100% test pass rate

  • 80% coverage

  • mypy strict mode
  • ruff linting
  • detect-secrets scan

Agent Behavior

  • 3-Strategy Rule: Try 3 approaches before asking for help
  • Deep Think: Simulate adversarial arguments
  • Attribution: Every commit must identify the agent/model

Repository Tiers

Tier Focus
P0 Vindicta-Portal (web gateway)
P1 Core engines (WARScribe, Primordia-AI, Meta-Oracle, APIs)
P2 Integration (Parser, UI components)
P3 Utilities (Dice, Entropy, Economy, Docs)

Constitution Reference

Full constitution: .github/copilot-instructions.md Detailed standards: .specify/memory/constitution.md