docs: add package-level ROADMAP template

CLAUDE.md

@@ -291,24 +291,29 @@ git push origin main --tags
 
 ## ROADMAP.md Rules (MANDATORY)
 
-**⛔ Every monorepo MUST have `ROADMAP.md` in root.**
+**⛔ Every monorepo MUST have ROADMAP.md files:**
 
-| Rule | Requirement |
+| Location | Purpose |
-|------|-------------|
+|----------|---------|
-| **Structure** | Phases → Milestones → Tasks with checkboxes |
+| `/ROADMAP.md` | Master roadmap: phases, architecture, status table |
-| **Versioning** | Each package has independent semver (v0.1.0) |
+| `/packages/*/ROADMAP.md` | Package roadmap: detailed milestones, tasks |
-| **Dependencies** | Show "Depends on: package vX.X.X" |
+| `/apps/*/ROADMAP.md` | App roadmap: features, UI/UX tasks |
-| **Status table** | Current version + next milestone per package |
-| **Architecture** | ASCII diagram of package relationships |
 
-**Milestone format:**
+**Root ROADMAP.md:**
 ```markdown
-#### 1.1 @project/core v0.1.0 - Feature Name
+## Current Status
-> **Depends on:** `@project/other v0.1.0`
+| Package | Version | Next Milestone |
+|---------|---------|----------------|
+| @project/core | v0.2.0 ✅ | v0.3.0 - Feature |
+```
 
+**Package ROADMAP.md:**
+```markdown
+## v0.3.0 - Feature Name
 | Task | Status |
 |------|--------|
-| Task description | [x] or [ ] |
+| Entity: Name | [x] |
+| Use case | [ ] |
 ```
 
 **Status indicators:**
@@ -317,11 +322,11 @@ git push origin main --tags
 ```
 
 **⛔ RULES:**
-- Update ROADMAP.md BEFORE starting new milestone
+- Root ROADMAP = bird's eye view (phases, dependencies)
+- Package ROADMAP = detailed tasks (checkboxes)
+- Update BEFORE starting new milestone
 - Mark tasks `[x]` immediately when done
-- Update "Current Status" table after each release
+- Never skip dependency order
-- Never skip dependency order (core → api → clients)
-- One package version = one atomic milestone
 
 **Dependency order (always):**
 ```

README.md

@@ -7,18 +7,24 @@ Standard templates for Claude Code configuration across all projects.
 | File | Description |
 |------|-------------|
 | `CLAUDE.md` | Claude Code configuration with all mandatory rules |
-| `ROADMAP.md` | Monorepo roadmap template with phases and milestones |
+| `ROADMAP.md` | Root roadmap: phases, architecture, status table |
+| `ROADMAP.package.md` | Package roadmap: detailed milestones per package |
 
 ## Usage
 
-1. Copy `CLAUDE.md` and `ROADMAP.md` to your new project root
+1. Copy to project root:
-2. Replace placeholders:
+   - `CLAUDE.md` → `/CLAUDE.md`
+   - `ROADMAP.md` → `/ROADMAP.md`
+2. Copy to each package/app:
+   - `ROADMAP.package.md` → `/packages/*/ROADMAP.md`
+   - `ROADMAP.package.md` → `/apps/*/ROADMAP.md`
+3. Replace placeholders:
    - `PROJECT_NAME` → your project name
    - `@project/*` → your package prefix (e.g., `@myapp/*`)
    - `/path/to/project` → actual project path
-3. Update package table with your packages
+4. Update package table with your packages
-4. Add project-specific sections if needed
+5. Add project-specific sections if needed
-5. Remove "Template Usage" section
+6. Remove "Template Usage" sections
 
 ## What's Included
 

ROADMAP.package.md

@@ -0,0 +1,75 @@
+# @project/package Roadmap
+
+## Current Version: v0.0.0
+
+## v0.1.0 - Foundation
+
+**Status:** ⏳ Planned
+
+**Goal:** Brief description of what this version achieves.
+
+| Task | Status |
+|------|--------|
+| Setup package structure | [ ] |
+| Add base types/interfaces | [ ] |
+| Write unit tests | [ ] |
+| Build & verify | [ ] |
+
+---
+
+## v0.2.0 - Core Features
+
+**Status:** ⏳ Planned
+
+**Depends on:** v0.1.0
+
+| Task | Status |
+|------|--------|
+| Feature 1 | [ ] |
+| Feature 2 | [ ] |
+| Tests | [ ] |
+| Build & verify | [ ] |
+
+---
+
+## v0.3.0 - Enhanced Features
+
+**Status:** ⏳ Planned
+
+**Depends on:** v0.2.0
+
+| Task | Status |
+|------|--------|
+| Enhancement 1 | [ ] |
+| Enhancement 2 | [ ] |
+| Tests | [ ] |
+| Build & verify | [ ] |
+
+---
+
+## v1.0.0 - Stable Release
+
+**Status:** ⏳ Planned
+
+**Criteria:**
+- [ ] All planned features implemented
+- [ ] 90% test coverage
+- [ ] Documentation complete
+- [ ] No known bugs
+
+---
+
+## Version History
+
+| Version | Date | Description |
+|---------|------|-------------|
+| v0.0.0 | TBD | Initial setup |
+
+---
+
+## Template Usage
+
+1. Replace `@project/package` with actual package name
+2. Define milestones based on root ROADMAP.md
+3. Add specific tasks for this package
+4. Remove this section