Files
kaizen-agentic/.claude/rules/stack-and-commands.md
tegwick ed0960e2a2 chore: migrate CLAUDE.md to @-import rule structure (custodian integration)
Register with state-hub under custodian domain. Replace monolithic CLAUDE.md
with thin @-import index; distribute content into .claude/rules/ per ops-bridge pattern.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 22:21:16 +01:00

1.1 KiB

Stack and Commands

Language: Python 3.8+ Package manager: uv / pip (.venv/) Test runner: pytest Linter/formatter: flake8 (100-char), black (88-char), mypy (strict)

Essential commands

make setup-complete     # First-time setup: venv + package + dev deps
source .venv/bin/activate
make test               # Run full test suite
make lint               # flake8 linting
make format             # black formatting
make clean              # Remove build artifacts

TDD workflow

make tdd-start ISSUE=X  # Start issue with requirements validation
make tdd-add-test       # Add test to current workspace
make tdd-status         # Show workspace state
make tdd-finish         # Move tests to main suite

Issue management

make issue-list         # All issues (Gitea)
make issue-list-open    # Open backlog
make issue-show ISSUE=X # Issue detail
make issue-create TITLE='...' BODY='...'

Run make help to see all available targets.

Core dependencies (pyproject.toml)

  • pyyaml>=6.0 — YAML config
  • click>=8.0.0 — CLI framework
  • pydantic>=2.0.0 — Data validation