agent-method 1.5.5 → 1.5.6

package/templates/starter/PROJECT.md

@@ -44,3 +44,37 @@
 1. {Principle 1}
 2. {Principle 2}
 3. {Principle 3}
+
+## Agent onboarding
+
+<!-- AGENT: Use these questions to populate this file during the first session.
+     Ask the user each question, draft this file from the answers, and show the
+     draft at the Stage 1 checkpoint before writing. Remove this section after
+     the file is populated — it's scaffolding, not permanent content. -->
+
+### Greenfield (no existing codebase)
+
+Ask the user:
+1. What is your project about? (1-2 sentences for the description above)
+2. Who is it for? (populate the Audiences table)
+3. What problem does it solve? (populate the Problem section)
+4. What technologies, languages, or frameworks will you use? (informs Solution + structure)
+5. What are 2-3 guiding principles for this project? (populate Principles)
+6. What is the top-level directory structure? (populate Project structure table)
+
+### Brownfield (existing codebase)
+
+<!-- AGENT: For brownfield projects, you've already scanned the project at Stage 1.
+     Pre-fill as much as possible from scan results. Only ask what you couldn't determine. -->
+
+Pre-fill from scan:
+- **Description**: infer from README, package.json description, or top-level docs
+- **Project structure**: build from directory listing — auto-populate the table
+- **Technologies**: extract from package.json, requirements.txt, config files, imports
+
+Ask the user only what the scan couldn't determine:
+1. Is this description accurate? (confirm or correct the auto-generated description)
+2. Who is the primary audience? (rarely inferable from code alone)
+3. What problem does this solve from the user's perspective? (intent, not implementation)
+4. What guiding principles drive decisions on this project? (conventions, priorities)
+5. Are there directories I should know about that aren't obvious from the structure? (hidden patterns, legacy areas)

package/templates/starter/Reviews/INDEX.md

@@ -0,0 +1,75 @@
+# Project Reviews
+
+<!-- AGENT: This is the review dashboard — a synthesized view of project intelligence.
+     Update sections when the corresponding source file changes significantly.
+
+     Source files: ROADMAP.md, PLAN.md, STATE.md, todos/backlog.md
+     When this file exceeds 300 lines, split sections into individual files
+     in this directory (roadmap.md, plan.md, state.md, backlog.md). -->
+
+## At a glance
+
+| Area | Status | Last updated |
+|------|--------|-------------|
+| Roadmap | {on track / behind / ahead} | {date} |
+| Plan | {active / blocked / between tasks} | {date} |
+| State | {N decisions, N blockers, N open questions} | {date} |
+| Backlog | {N items} | {date} |
+
+## Roadmap review
+
+<!-- AGENT: Synthesize from ROADMAP.md. Phase progress, milestone tracking. -->
+
+### Phase progress
+
+| Phase | Status | Completion |
+|-------|--------|------------|
+<!-- Populate from ROADMAP.md -->
+
+### Velocity notes
+
+<!-- Brief observations about project velocity and trajectory. -->
+
+## Plan review
+
+<!-- AGENT: Synthesize from PLAN.md. Current task status, execution patterns. -->
+
+### Current task
+
+<!-- What's being worked on, how it's progressing. -->
+
+### Execution patterns
+
+<!-- Observations about plan execution — revision patterns, task sizing accuracy. -->
+
+## State review
+
+<!-- AGENT: Synthesize from STATE.md. Decision trends, blocker aging, question resolution. -->
+
+### Decision summary
+
+- **Total decisions**: {count}
+- **Recent decisions** (last 5):
+
+<!-- List last 5 decisions from STATE.md -->
+
+### Blocker status
+
+<!-- Active blockers, how long they've been open, resolution progress. -->
+
+### Open questions
+
+<!-- Active open questions, aging analysis, resolution rate. -->
+
+## Backlog review
+
+<!-- AGENT: Synthesize from todos/backlog.md. Item counts, categories, aging. -->
+
+### Summary
+
+- **Total items**: {count}
+- **Categories**: {list with counts}
+
+### Aging
+
+<!-- How old are backlog items? Any that need attention? -->

package/templates/starter/SUMMARY.md

@@ -0,0 +1,27 @@
+# Summary
+
+<!-- AGENT: This file is the session audit trail — a chronological record of work done.
+     The management digest has moved to Management/DIGEST.md.
+     Append an entry after each session or significant task using the format below.
+     Never edit previous entries. -->
+
+## Session audit trail
+
+<!-- INSTRUCTION: Use this format for each entry:
+
+### {Date} — {Brief title}
+
+**Plan**: {What was planned for this session}
+**Outcome**: {What was actually accomplished}
+
+**Files created**:
+- {path/to/new-file.md}
+
+**Files updated**:
+- {path/to/updated-file.md} — {what changed}
+
+**Key decisions**:
+- {Decision and rationale — should match what's in STATE.md}
+
+**Next**: {What should happen in the following session — this is the bridge}
+-->

package/templates/starter/agentWorkflows/INDEX.md

@@ -0,0 +1,61 @@
+# Agent Workflows
+
+<!-- AGENT: This file tracks how the methodology performs in practice.
+     Update after high-effort sessions by reviewing SESSION-LOG.md patterns.
+
+     Source: SESSION-LOG.md entries, agent self-observation during sessions.
+     When this file exceeds 300 lines, split sections into individual files
+     in this directory (sessions.md, patterns.md, observations.md). -->
+
+## Workflow summary
+
+| Workflow | Times used | Last used | Typical effort |
+|----------|-----------|-----------|---------------|
+<!-- Populate from SESSION-LOG.md workflow field -->
+
+## Session patterns
+
+<!-- AGENT: Synthesize from SESSION-LOG.md. Look for patterns across sessions. -->
+
+### Effort distribution
+
+| Effort level | Count | Percentage |
+|-------------|-------|------------|
+| Low | {N} | {%} |
+| Medium | {N} | {%} |
+| High | {N} | {%} |
+
+### Common query types
+
+<!-- Which query types appear most often? -->
+
+### Acceptance rates
+
+<!-- How often is agent output accepted vs. revised? -->
+
+- **Accepted**: {count} ({%})
+- **Edited**: {count} ({%})
+- **Revised**: {count} ({%})
+- **Rejected**: {count} ({%})
+- **Redirected**: {count} ({%})
+
+## Behavioral patterns
+
+<!-- AGENT: Record patterns observed across sessions. What works well, what causes friction. -->
+
+### What works
+
+<!-- Patterns that consistently lead to accepted results. -->
+
+### Friction points
+
+<!-- Recurring issues, methodology rules that cause difficulty. -->
+
+## Observations
+
+<!-- AGENT: Record methodology observations — findings with implications for
+     how the methodology could be improved or adapted for this project. -->
+
+| Date | Observation | Implication | Severity |
+|------|-------------|-------------|----------|
+<!-- Append observations as they arise -->

package/templates/starter/intro/README.md

@@ -0,0 +1,37 @@
+# Methodology Overview
+
+This project uses the **wwa** (Working With Agents) methodology for AI-agent-assisted development. The methodology gives your AI agent persistent memory, structured workflows, and scoped context loading across sessions.
+
+## How it works
+
+Your agent reads an entry point file (CLAUDE.md, .cursorrules, or AGENT.md) at the start of every session. That file tells the agent:
+
+- **What to read** — scoping rules match your question to the right files
+- **What to update** — cascade rules keep dependent files in sync
+- **How to work** — workflows guide the agent through structured steps
+
+Key files the agent manages:
+
+| File | Purpose |
+|------|---------|
+| STATE.md | Decisions, blockers, current position (cross-session memory) |
+| PLAN.md | Current task with verification criteria |
+| ROADMAP.md | Phase breakdown with gate criteria |
+| .context/BASE.md | Core project context — architecture, codebase map |
+| .context/DOCS-MAP.md | Maps your project components to their documentation |
+
+## Your project's docs/
+
+The `docs/` folder is reserved for **your project's documentation** — API references, architecture guides, setup instructions, etc. It is not created at setup time. Instead, the agent proposes new docs/ files as your project grows, based on scaffolding rules in `.context/DOCS-MAP.md`.
+
+## Full documentation
+
+For the complete methodology guide, templates reference, and architecture docs:
+
+**https://github.com/anthropics/agent-method**
+
+Key pages:
+- [Quick Start](https://github.com/anthropics/agent-method/blob/main/docs/guides/quick-start.md)
+- [For Developers](https://github.com/anthropics/agent-method/blob/main/docs/guides/for-developers.md)
+- [File Roles](https://github.com/anthropics/agent-method/blob/main/docs/architecture/file-roles.md)
+- [CLI Tools](https://github.com/anthropics/agent-method/blob/main/docs/guides/for-developers/cli-tools.md)

package/templates/full/docs/index.md

@@ -1,46 +0,0 @@
-# {Project Name} — Documentation
-
-<!-- INSTRUCTION: This is the human-facing project dashboard.
-     It provides a high-level view of the project for non-agent audiences
-     (managers, reviewers, teammates). Keep it visual and navigable. -->
-
-## Project overview
-
-<!-- INSTRUCTION: Brief description of what the project does and its current state.
-     Link to PROJECT.md for the full vision. -->
-
-See [PROJECT.md](../PROJECT.md) for the full project vision and scope.
-
-## Current status
-
-<!-- INSTRUCTION: Update this when phases complete. Show progress at a glance. -->
-
-| Phase | Status | Gate |
-|-------|--------|------|
-| Phase 1 — {name} | {pending/in-progress/done} | {PASSED / not yet} |
-| Phase 2 — {name} | {pending} | {not yet} |
-
-## Architecture
-
-<!-- INSTRUCTION: High-level architecture description for human readers.
-     Diagrams, component descriptions, key design decisions. -->
-
-{Describe or diagram your project architecture}
-
-## Key decisions
-
-<!-- INSTRUCTION: Surface important decisions from STATE.md in a human-readable format.
-     Not every decision — just the ones that affect the project's direction. -->
-
-| Decision | Rationale | Date |
-|----------|-----------|------|
-| {Important decision} | {Why} | {When} |
-
-## Navigation
-
-<!-- INSTRUCTION: Add links to other docs as you create them. -->
-
-| Document | What it covers |
-|----------|---------------|
-| [PROJECT.md](../PROJECT.md) | Project vision and scope |
-| [ROADMAP.md](../ROADMAP.md) | Phase breakdown and progress |