hool-cli 0.7.4 → 0.9.0

package/presets/team/templates/operations/governor-rules.md

@@ -0,0 +1,22 @@
+# Governor Rules
+
+<!-- Hard rules that all agents must follow. Governor audits against these. -->
+<!-- Governor can APPEND new rules but NEVER modify or remove existing ones. -->
+
+## Core Rules
+
+- [CRITICAL] No agent may modify its own prompt file or any other agent's prompt file. Escalate to needs-human-review.md.
+- [CRITICAL] Product Lead must NEVER edit files in src/frontend/ or src/backend/ directly. Always message the assigned teammate.
+- [CRITICAL] Devs must NEVER make architectural decisions. Follow LLD exactly. Message lead if something should change.
+- [CRITICAL] No agent may modify governor-rules.md except the Governor (append only) or a human.
+- [HIGH] All agents must update their memory files (cold.md, hot.md, task-log.md) before going idle.
+- [HIGH] All agents must read governor-feedback.md before starting work and verify they don't repeat violations.
+- [HIGH] Devs must follow TDD: write tests before implementation. Implementation-first is a violation.
+- [HIGH] FE Dev and FE Lead commit to src/frontend/ git only. BE Dev and BE Lead commit to src/backend/ git only. Cross-repo commits are violations.
+- [HIGH] Contracts in .hool/phases/05-contracts/ are the source of truth for API shapes. Any deviation by devs is a violation.
+- [MEDIUM] All agents must read their client-preferences.md before making decisions and honour preferences.
+- [MEDIUM] No agent may create files outside their writable paths.
+- [MEDIUM] Agents must use teammate messaging for real-time coordination, not file-based routing.
+
+## Added Rules
+<!-- Governor appends new rules below this line -->

package/presets/team/templates/operations/human-feedback.md

@@ -0,0 +1,7 @@
+# Human Feedback
+
+<!-- General feedback from the user that applies across the project. -->
+<!-- Captured by PL whenever the user gives guidance or correction. -->
+
+<!-- Format: -->
+<!-- - [date]: [feedback] — context: [why they said this] -->

package/presets/team/templates/operations/inconsistencies.md

@@ -0,0 +1,12 @@
+# Inconsistencies
+
+<!-- Doc-vs-doc and doc-vs-code inconsistencies. -->
+<!-- Written by leads (review), devs (implementation), and PL (cross-check). -->
+
+<!-- Format: -->
+<!-- ## INC-XXX: [title] -->
+<!-- - **Found by**: [agent] -->
+<!-- - **Type**: spec-vs-code | contract-vs-code | design-vs-code | doc-vs-doc -->
+<!-- - **Source A**: [what doc A says] — file: [path] -->
+<!-- - **Source B**: [what doc B / code says] — file: [path] -->
+<!-- - **Resolution**: [how it was resolved] | pending -->

package/presets/team/templates/operations/issues.md

@@ -0,0 +1,13 @@
+# Issues
+
+<!-- Known issues, tech debt patterns, and systemic problems. -->
+<!-- Written by Forensic (pattern detection), devs (code-level debt), and leads (architectural debt). -->
+
+<!-- Format: -->
+<!-- ## ISS-XXX: [title] -->
+<!-- - **Found by**: [agent] -->
+<!-- - **Type**: bug-pattern | tech-debt | design-flaw -->
+<!-- - **Description**: what's happening and why -->
+<!-- - **Affected files**: list -->
+<!-- - **Fix strategy**: how to fix properly -->
+<!-- - **Related bugs**: BUG-XXX, BUG-YYY -->

package/presets/team/templates/operations/metrics.md

@@ -0,0 +1,4 @@
+# Metrics
+
+- tool-calls: 0
+- task-completions: 0

package/presets/team/templates/operations/needs-human-review.md

@@ -0,0 +1,11 @@
+# Needs Human Review
+
+<!-- Items requiring human decision or approval. -->
+<!-- Agents write here when they encounter ambiguity, need process changes, or have structural suggestions. -->
+
+<!-- Format: -->
+<!-- ## [date] [agent]: [title] -->
+<!-- - **Context**: why this needs human input -->
+<!-- - **Options**: what the choices are -->
+<!-- - **Recommendation**: agent's suggested option (if any) -->
+<!-- - **Status**: pending | reviewed | resolved -->

package/presets/team/templates/operations/task-board.md

@@ -0,0 +1,11 @@
+# Task Board
+
+## Current Phase Tasks
+<!-- Tasks for the active phase. Created by leads (Phase 6) or PL. -->
+<!-- Format: - [ ] TASK-XXX: description | assigned: agent | files: list | depends: task-ids | contract: ref | spec: ref -->
+
+## Completed Tasks
+<!-- Moved here when done -->
+
+## Blocked Tasks
+<!-- Tasks that can't proceed. Include reason. -->

package/presets/team/templates/phases/00-init/project-profile.md

@@ -0,0 +1,45 @@
+# Project Profile
+
+## Project
+- **Name**: {{PROJECT_NAME}}
+- **Type**: web-app | api-only | cli-tool | animation | browser-game | mobile | desktop | other
+- **Description**: {{ONE_LINE_DESCRIPTION}}
+
+## Mode
+- **Execution mode**: interactive | full-hool
+
+## Applicable Phases
+| # | Phase | Applies | Notes |
+|---|-------|---------|-------|
+| 0 | Init | yes | — |
+| 1 | Brainstorm | yes | — |
+| 2 | Spec | yes | — |
+| 3 | Design | {{yes/no}} | Skip for API-only, CLI |
+| 4 | Architecture | yes | — |
+| 5 | Contracts | {{yes/no}} | Skip if no FE-BE split |
+| 6 | Tasks | yes | — |
+| 7 | Implementation | yes | — |
+| 8 | Review | yes | — |
+| 9 | QA | yes | — |
+| 10 | Forensic | yes | On-demand (bug loop) |
+| 11 | Ship | yes | — |
+| 12 | Retrospective | yes | — |
+
+## Active Agents
+| Agent | Active | Reason |
+|-------|--------|--------|
+| Product Lead | yes | Always |
+| BE Tech Lead | {{yes/no}} | {{reason}} |
+| FE Tech Lead | {{yes/no}} | {{reason}} |
+| BE Dev | {{yes/no}} | {{reason}} |
+| FE Dev | {{yes/no}} | {{reason}} |
+| QA | yes | Always |
+| Forensic | yes | Always |
+| Governor | yes | Always |
+
+## Git Remotes
+- **Frontend**: {{url or "local only"}}
+- **Backend**: {{url or "local only"}}
+
+## Hard Constraints
+<!-- e.g., "Must run on Node 18+", "60fps minimum for animations" -->

package/presets/team/templates/phases/01-brainstorm/brainstorm.md

@@ -0,0 +1,33 @@
+# Brainstorm
+
+## Vision
+<!-- One sentence: what is this? -->
+
+## Users
+<!-- Who uses it and why? -->
+
+## Core Journeys
+<!-- 3-5 critical user paths -->
+1.
+2.
+3.
+
+## Constraints
+### Technical
+### Business
+### User
+
+## Scope Boundary
+### In (MVP)
+### Out (Deferred)
+
+## Risks
+<!-- Top 3 assumptions that could be wrong -->
+1.
+2.
+3.
+
+## Integrations
+<!-- External dependencies and status -->
+| Service | Purpose | Status |
+|---------|---------|--------|

package/presets/team/templates/phases/02-spec/spec.md

@@ -0,0 +1,28 @@
+# Spec
+
+## Overview
+<!-- What this feature set does -->
+
+## User Stories
+
+### US-001: [Story Title]
+**As a** [role]
+**I want to** [action]
+**So that** [benefit]
+
+#### Acceptance Criteria
+- [ ] AC-1: GIVEN [pre] WHEN [action] THEN [result]
+
+#### Edge Cases
+- EC-1: [scenario] → [expected behavior]
+
+## Data Model
+<!-- High-level entity relationships -->
+
+## Non-Functional Requirements
+### Performance
+### Security
+### Accessibility
+
+## Open Questions
+<!-- Anything needing user clarification -->

package/presets/team/templates/phases/03-design/design.md

@@ -0,0 +1,26 @@
+# Design
+
+## Design System
+### Colors
+### Typography
+### Spacing
+### Border Radius
+### Shadows
+### Breakpoints
+
+## Screen Inventory
+| Screen | Route | Description | Design Card |
+|--------|-------|-------------|-------------|
+
+## Component System
+### Atoms
+### Molecules
+### Organisms
+### Templates/Layouts
+
+## Interaction Patterns
+### Form Submission
+### Error Display
+### Loading States
+### Empty States
+### Transitions

package/presets/team/templates/phases/04-architecture/architecture.md

@@ -0,0 +1,26 @@
+# Architecture (Shared)
+
+## Tech Stack
+| Layer | Choice | Why |
+|-------|--------|-----|
+| Frontend | | |
+| Backend | | |
+| Database | | |
+| Auth | | |
+| Deployment | | |
+
+## System Diagram
+<!-- Text-based system diagram showing major components -->
+
+## Module Breakdown
+<!-- Logical modules/packages for both FE and BE -->
+
+## Cross-Cutting Concerns
+### Authentication Flow
+### Error Handling Strategy
+### Logging Strategy
+### Environment Configuration
+
+## Decisions
+<!-- Non-obvious architectural decisions with trade-offs -->
+<!-- See skills/architect.md for decision format -->

package/presets/team/templates/phases/05-contracts/_index.md

@@ -0,0 +1,20 @@
+# API Contracts Index
+
+<!-- Master list of all API contracts, grouped by domain. -->
+<!-- Each domain has its own file with full endpoint specifications. -->
+
+## Domains
+| Domain | File | Endpoints |
+|--------|------|-----------|
+
+## Conventions
+- **Base URL**: `/api/v1/`
+- **Auth**: Bearer token in Authorization header
+- **Error format**: `{ "error": "ERROR_CODE", "message": "Human readable", "details": [...] }`
+- **Pagination**: `?page=1&limit=20` → `{ "data": [...], "meta": { "page": 1, "limit": 20, "total": 100 } }`
+- **Timestamps**: ISO 8601 format
+
+## Agreement
+- **BE Lead (POC)**: [agreed / pending]
+- **FE Lead (Rebuttal)**: [agreed / pending]
+- **Date**: [YYYY-MM-DD]

package/presets/team/templates/phases/09-qa/test-plan.md

@@ -0,0 +1,29 @@
+# Test Plan
+
+## Coverage Matrix
+| Spec Ref | Acceptance Criterion | Test Case(s) | Type | Status |
+|----------|---------------------|--------------|------|--------|
+
+## Test Infrastructure
+- **Unit test framework**: {{framework}}
+- **Integration test framework**: {{framework}}
+- **E2E test framework**: {{framework}}
+- **Visual testing**: Playwright screenshots vs design cards
+- **Test data**: {{strategy}}
+
+## Test Cases
+<!-- For projects with >10 cases, split into cases/ directory -->
+
+### TC-001: [Test Name]
+- **Type**: unit | integration | e2e | visual
+- **Source**: US-XXX/AC-X
+- **Precondition**: [setup]
+- **Steps**:
+  1. [action]
+- **Expected**: [result]
+- **Edge variant**: [if applicable]
+
+## Execution Results
+<!-- Filled during test execution -->
+| Run | Date | Unit | Integration | E2E | Visual | Bugs Found |
+|-----|------|------|-------------|-----|--------|------------|

package/presets/team/templates/phases/12-retrospective/retrospective.md

@@ -0,0 +1,24 @@
+# Retrospective — {{CYCLE_NAME}}
+
+## Cross-Agent Patterns
+<!-- Patterns observed across multiple agents -->
+
+## Plan vs Reality
+<!-- Where spec/architecture diverged from what was built -->
+
+## What Went Well
+<!-- Things that worked smoothly -->
+
+## What Didn't
+<!-- Things that caused friction, rework, or confusion -->
+
+## Suggested Process Changes
+<!-- Severity: high | medium | low -->
+- **[severity]** [suggestion] — reason: [why]
+
+## Metrics
+- Bugs found: {{count}}
+- Inconsistencies logged: {{count}}
+- Tasks planned vs actual: {{planned}} / {{actual}}
+- Phases that caused rework: {{list}}
+- Governor violations: {{count}}