npm - @cluesmith/codev - Versions diffs - 1.1.0 → 1.2.0 - Mend

@cluesmith/codev 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (146) hide show

package/dist/agent-farm/cli.d.ts.map +1 -1
package/dist/agent-farm/cli.js +19 -0
package/dist/agent-farm/cli.js.map +1 -1
package/dist/agent-farm/commands/cleanup.d.ts.map +1 -1
package/dist/agent-farm/commands/cleanup.js +18 -1
package/dist/agent-farm/commands/cleanup.js.map +1 -1
package/dist/agent-farm/commands/consult.d.ts +16 -0
package/dist/agent-farm/commands/consult.d.ts.map +1 -0
package/dist/agent-farm/commands/consult.js +51 -0
package/dist/agent-farm/commands/consult.js.map +1 -0
package/dist/agent-farm/commands/open.js +6 -6
package/dist/agent-farm/commands/open.js.map +1 -1
package/dist/agent-farm/commands/spawn.d.ts.map +1 -1
package/dist/agent-farm/commands/spawn.js +51 -42
package/dist/agent-farm/commands/spawn.js.map +1 -1
package/dist/agent-farm/commands/start.d.ts.map +1 -1
package/dist/agent-farm/commands/start.js +9 -14
package/dist/agent-farm/commands/start.js.map +1 -1
package/dist/agent-farm/commands/util.js +2 -2
package/dist/agent-farm/commands/util.js.map +1 -1
package/dist/agent-farm/db/errors.d.ts +4 -0
package/dist/agent-farm/db/errors.d.ts.map +1 -1
package/dist/agent-farm/db/errors.js +8 -0
package/dist/agent-farm/db/errors.js.map +1 -1
package/dist/agent-farm/servers/dashboard-server.js +125 -71
package/dist/agent-farm/servers/dashboard-server.js.map +1 -1
package/dist/agent-farm/servers/open-server.d.ts +9 -0
package/dist/agent-farm/servers/open-server.d.ts.map +1 -0
package/dist/agent-farm/servers/{annotate-server.js → open-server.js} +17 -15
package/dist/agent-farm/servers/open-server.js.map +1 -0
package/dist/agent-farm/servers/tower-server.js +4 -7
package/dist/agent-farm/servers/tower-server.js.map +1 -1
package/dist/agent-farm/state.d.ts +5 -0
package/dist/agent-farm/state.d.ts.map +1 -1
package/dist/agent-farm/state.js +17 -0
package/dist/agent-farm/state.js.map +1 -1
package/dist/agent-farm/types.d.ts +1 -1
package/dist/agent-farm/types.d.ts.map +1 -1
package/dist/agent-farm/utils/config.d.ts.map +1 -1
package/dist/agent-farm/utils/config.js +13 -7
package/dist/agent-farm/utils/config.js.map +1 -1
package/dist/agent-farm/utils/port-registry.d.ts +1 -1
package/dist/agent-farm/utils/port-registry.d.ts.map +1 -1
package/dist/agent-farm/utils/port-registry.js +1 -1
package/dist/agent-farm/utils/port-registry.js.map +1 -1
package/dist/agent-farm/utils/shell.d.ts +19 -0
package/dist/agent-farm/utils/shell.d.ts.map +1 -1
package/dist/agent-farm/utils/shell.js +28 -0
package/dist/agent-farm/utils/shell.js.map +1 -1
package/dist/cli.d.ts.map +1 -1
package/dist/cli.js +33 -0
package/dist/cli.js.map +1 -1
package/dist/commands/adopt.d.ts +3 -0
package/dist/commands/adopt.d.ts.map +1 -1
package/dist/commands/adopt.js +31 -25
package/dist/commands/adopt.js.map +1 -1
package/dist/commands/consult/index.d.ts +3 -2
package/dist/commands/consult/index.d.ts.map +1 -1
package/dist/commands/consult/index.js +128 -54
package/dist/commands/consult/index.js.map +1 -1
package/dist/commands/doctor.d.ts.map +1 -1
package/dist/commands/doctor.js +88 -36
package/dist/commands/doctor.js.map +1 -1
package/dist/commands/eject.d.ts +18 -0
package/dist/commands/eject.d.ts.map +1 -0
package/dist/commands/eject.js +149 -0
package/dist/commands/eject.js.map +1 -0
package/dist/commands/import.d.ts +16 -0
package/dist/commands/import.d.ts.map +1 -0
package/dist/commands/import.js +278 -0
package/dist/commands/import.js.map +1 -0
package/dist/commands/init.d.ts +3 -0
package/dist/commands/init.d.ts.map +1 -1
package/dist/commands/init.js +32 -27
package/dist/commands/init.js.map +1 -1
package/dist/lib/projectlist-parser.d.ts +70 -0
package/dist/lib/projectlist-parser.d.ts.map +1 -0
package/dist/lib/projectlist-parser.js +200 -0
package/dist/lib/projectlist-parser.js.map +1 -0
package/dist/lib/skeleton.d.ts +41 -0
package/dist/lib/skeleton.d.ts.map +1 -0
package/dist/lib/skeleton.js +110 -0
package/dist/lib/skeleton.js.map +1 -0
package/dist/lib/templates.d.ts +2 -1
package/dist/lib/templates.d.ts.map +1 -1
package/dist/lib/templates.js +11 -10
package/dist/lib/templates.js.map +1 -1
package/package.json +5 -4
package/{templates → skeleton}/DEPENDENCIES.md +3 -48
package/skeleton/bin/agent-farm +7 -0
package/skeleton/docs/commands/agent-farm.md +469 -0
package/skeleton/docs/commands/codev.md +253 -0
package/skeleton/docs/commands/consult.md +286 -0
package/skeleton/docs/commands/overview.md +108 -0
package/skeleton/maintain/.gitkeep +2 -0
package/{templates → skeleton}/protocols/experiment/protocol.md +2 -2
package/skeleton/protocols/maintain/protocol.md +502 -0
package/skeleton/protocols/maintain/templates/maintenance-run.md +64 -0
package/{templates → skeleton}/protocols/spider/protocol.md +9 -9
package/{templates/protocols/spider-solo → skeleton/protocols/spider}/templates/plan.md +22 -1
package/{templates/protocols/spider-solo → skeleton/protocols/spider}/templates/spec.md +30 -1
package/skeleton/protocols/tick/protocol.md +277 -0
package/skeleton/resources/lessons-learned.md +30 -0
package/skeleton/resources/workflow-reference.md +242 -0
package/skeleton/roles/architect.md +283 -0
package/{templates → skeleton}/roles/builder.md +2 -0
package/skeleton/roles/review-types/impl-review.md +56 -0
package/skeleton/roles/review-types/integration-review.md +68 -0
package/skeleton/roles/review-types/plan-review.md +59 -0
package/skeleton/roles/review-types/pr-ready.md +72 -0
package/skeleton/roles/review-types/spec-review.md +55 -0
package/skeleton/templates/lessons-learned.md +28 -0
package/{templates → skeleton}/templates/projectlist.md +17 -16
package/dist/agent-farm/servers/annotate-server.d.ts +0 -9
package/dist/agent-farm/servers/annotate-server.d.ts.map +0 -1
package/dist/agent-farm/servers/annotate-server.js.map +0 -1
package/templates/agents/architecture-documenter.md +0 -189
package/templates/agents/codev-updater.md +0 -276
package/templates/agents/spider-protocol-updater.md +0 -118
package/templates/annotate.html +0 -903
package/templates/bin/agent-farm +0 -18
package/templates/bin/annotate-server.js +0 -140
package/templates/dashboard-split.html +0 -1679
package/templates/dashboard.html +0 -149
package/templates/protocols/maintain/protocol.md +0 -235
package/templates/protocols/spider/templates/plan.md +0 -169
package/templates/protocols/spider/templates/review.md +0 -207
package/templates/protocols/spider/templates/spec.md +0 -140
package/templates/protocols/spider-solo/protocol.md +0 -619
package/templates/protocols/tick/protocol.md +0 -250
package/templates/roles/architect.md +0 -230
package/templates/tower.html +0 -1032
/package/{templates/AGENTS.md → skeleton/AGENTS.md.template} +0 -0
/package/{templates/CLAUDE.md → skeleton/CLAUDE.md.template} +0 -0
/package/{templates → skeleton}/bin/codev-doctor +0 -0
/package/{templates → skeleton}/builders.md +0 -0
/package/{templates → skeleton}/config.json +0 -0
/package/{templates → skeleton}/plans/.gitkeep +0 -0
/package/{templates → skeleton}/protocols/experiment/templates/notes.md +0 -0
/package/{templates/protocols/spider-solo → skeleton/protocols/spider}/templates/review.md +0 -0
/package/{templates → skeleton}/protocols/tick/templates/plan.md +0 -0
/package/{templates → skeleton}/protocols/tick/templates/review.md +0 -0
/package/{templates → skeleton}/protocols/tick/templates/spec.md +0 -0
/package/{templates → skeleton}/reviews/.gitkeep +0 -0
/package/{templates → skeleton}/roles/consultant.md +0 -0
/package/{templates → skeleton}/specs/.gitkeep +0 -0

package/templates/dashboard.html DELETED Viewed

@@ -1,149 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <title>AF: {{PROJECT_NAME}}</title>
-  <style>
-    * { box-sizing: border-box; margin: 0; padding: 0; }
-    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; padding: 20px; background: #1a1a1a; color: #fff; }
-    h1 { margin-bottom: 20px; font-size: 24px; font-weight: 600; }
-    h2 { font-size: 16px; font-weight: 500; margin-bottom: 15px; color: #888; }
-    .layout { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; }
-    .layout.no-builders { grid-template-columns: 1fr; }
-    .architect-section { }
-    .builders-section { }
-    .terminal-card { background: #2a2a2a; border-radius: 8px; overflow: hidden; margin-bottom: 15px; }
-    .terminal-header { padding: 10px 15px; background: #333; display: flex; justify-content: space-between; align-items: center; }
-    .terminal-header h3 { font-size: 14px; font-weight: 500; }
-    .terminal-status { font-size: 12px; padding: 2px 8px; border-radius: 4px; font-weight: 500; }
-    .status-architect { background: #8b5cf6; }
-    .status-spawning { background: #6366f1; }
-    .status-implementing { background: #3b82f6; }
-    .status-blocked { background: #ef4444; }
-    .status-pr-ready { background: #22c55e; }
-    .status-reviewing { background: #f59e0b; }
-    .status-complete { background: #10b981; }
-    iframe { width: 100%; height: 500px; border: none; background: #000; }
-    .builders-section iframe { height: 400px; }
-    .no-terminal { text-align: center; padding: 60px 40px; color: #666; background: #2a2a2a; border-radius: 8px; }
-    .no-terminal code { background: #333; padding: 4px 8px; border-radius: 4px; font-size: 13px; }
-    .instructions { margin-top: 20px; padding: 15px; background: #2a2a2a; border-radius: 8px; font-size: 13px; }
-    .instructions code { background: #333; padding: 2px 6px; border-radius: 3px; }
-    .instructions strong { color: #888; }
-    .refresh-btn {
-      position: fixed; top: 20px; right: 20px;
-      background: #333; color: #fff; border: none; padding: 8px 16px;
-      border-radius: 6px; cursor: pointer; font-size: 13px;
-    }
-    .refresh-btn:hover { background: #444; }
-    .builder-grid { display: grid; grid-template-columns: 1fr; gap: 15px; }
-    @media (min-width: 1400px) {
-      .builder-grid { grid-template-columns: 1fr 1fr; }
-      .builders-section iframe { height: 350px; }
-    }
-  </style>
-</head>
-<body>
-  <button class="refresh-btn" onclick="location.reload()">Refresh</button>
-  <h1>Agent Farm - {{PROJECT_NAME}}</h1>
-  <div class="layout" id="layout">
-    <!-- Content inserted by JavaScript -->
-  </div>
-  <div class="instructions">
-    <strong>Commands:</strong>
-    <code>architect start</code> ·
-    <code>architect spawn --project XXXX</code> ·
-    <code>architect open XXXX FILE</code> ·
-    <code>architect stop</code>
-  </div>
-  <script>
-    // Configuration - updated by architect CLI
-    const architectPort = 7680;
-    const builders = [];
-    const layout = document.getElementById('layout');
-    // Check if architect console is running
-    const architectRunning = architectPort > 0;
-    // Build architect section
-    let architectHtml = '';
-    if (architectRunning) {
-      architectHtml = `
-        <div class="architect-section">
-          <h2>Architect Console</h2>
-          <div class="terminal-card">
-            <div class="terminal-header">
-              <h3>Architect</h3>
-              <span class="terminal-status status-architect">active</span>
-            </div>
-            <iframe src="http://localhost:${architectPort}" title="Architect Console" allow="clipboard-read; clipboard-write"></iframe>
-          </div>
-        </div>
-      `;
-    } else {
-      architectHtml = `
-        <div class="architect-section">
-          <h2>Architect Console</h2>
-          <div class="no-terminal">
-            <p style="margin-bottom: 15px;">Architect console not running.</p>
-            <p>Run <code>architect start</code> to begin.</p>
-          </div>
-        </div>
-      `;
-    }
-    // Build builders section
-    let buildersHtml = '';
-    if (builders.length > 0) {
-      buildersHtml = `
-        <div class="builders-section">
-          <h2>Builders (${builders.length})</h2>
-          <div class="builder-grid">
-            ${builders.map(b => {
-              const statusClass = 'status-' + b.status.replace(/[^a-z]/g, '');
-              return `
-                <div class="terminal-card">
-                  <div class="terminal-header">
-                    <h3>Builder ${b.id}: ${b.name}</h3>
-                    <span class="terminal-status ${statusClass}">${b.status} (${b.phase})</span>
-                  </div>
-                  <iframe src="http://localhost:${b.port}" title="Builder ${b.id}" allow="clipboard-read; clipboard-write"></iframe>
-                </div>
-              `;
-            }).join('')}
-          </div>
-        </div>
-      `;
-    } else {
-      buildersHtml = `
-        <div class="builders-section">
-          <h2>Builders</h2>
-          <div class="no-terminal">
-            <p style="margin-bottom: 15px;">No active builders.</p>
-            <p>Run <code>architect spawn --project XXXX</code></p>
-          </div>
-        </div>
-      `;
-    }
-    // Adjust layout if no builders
-    if (builders.length === 0) {
-      layout.classList.add('no-builders');
-    }
-    layout.innerHTML = architectHtml + buildersHtml;
-  </script>
-</body>
-</html>

package/templates/protocols/maintain/protocol.md DELETED Viewed

@@ -1,235 +0,0 @@
-# MAINTAIN Protocol
-## Overview
-MAINTAIN is a periodic maintenance protocol for keeping codebases healthy. Unlike SPIDER/TICK (which have sequential phases), MAINTAIN is a **task list** where tasks can run in parallel and some require human review.
-**Core Principle**: Regular maintenance prevents technical debt accumulation.
-## When to Use MAINTAIN
-### Triggers
-- Before a release (clean slate for shipping)
-- Quarterly maintenance window
-- After completing a major feature
-- When the codebase feels "crusty"
-- Before major refactoring efforts
-### Skip MAINTAIN for
-- Active development branches with pending PRs
-- Emergency production issues
-- When tests are failing (fix tests first)
-## Execution Model
-MAINTAIN is executed by a Builder, spawned by the Architect:
-```
-Architect: "Time for maintenance"
-    ↓
-af spawn --protocol maintain
-    ↓
-Builder works through task list
-    ↓
-PR with maintenance changes
-    ↓
-Architect reviews → Builder merges
-```
-## Prerequisites
-Before starting MAINTAIN:
-- [ ] Git working directory is clean
-- [ ] All tests are passing
-- [ ] No pending merges or PRs in flight
----
-## Task List
-### Code Hygiene Tasks
-| Task | Parallelizable | Human Review? | Description |
-|------|----------------|---------------|-------------|
-| Remove dead code | Yes | No | Delete unused functions, imports, unreachable code |
-| Remove unused dependencies | Yes | Yes | Check package.json/requirements.txt for unused packages |
-| Clean unused flags | Yes | No | Remove feature flags that are always on/off |
-| Fix flaky tests | No | Yes | Investigate and fix intermittently failing tests |
-| Update outdated dependencies | Yes | Yes | Bump dependencies with breaking change review |
-**Tools**:
-```bash
-# TypeScript/JavaScript
-npx ts-prune          # Find unused exports
-npx depcheck          # Find unused dependencies
-# Python
-ruff check --select F401   # Find unused imports
-```
-### Documentation Sync Tasks
-| Task | Parallelizable | Human Review? | Description |
-|------|----------------|---------------|-------------|
-| Update arch.md | Yes | No | Sync architecture doc with actual codebase |
-| Generate lessons-learned.md | Yes | Yes | Extract wisdom from review documents |
-| Sync CLAUDE.md ↔ AGENTS.md | Yes | No | Ensure both files match |
-| Check spec/plan/review consistency | Yes | Yes | Find specs without reviews, plans that don't match code |
-| Remove stale doc references | Yes | No | Delete references to deleted code/files |
-### Project Tracking Tasks
-| Task | Parallelizable | Human Review? | Description |
-|------|----------------|---------------|-------------|
-| Update projectlist.md status | Yes | No | Update project statuses |
-| Archive terminal projects | Yes | No | Move completed/abandoned to terminal section |
----
-## Task Details
-### Update arch.md
-Scan the actual codebase and update `codev/resources/arch.md`:
-1. Verify directory structure matches documented structure
-2. Update component descriptions
-3. Add new utilities/helpers discovered
-4. Remove references to deleted code
-5. Update technology stack if changed
-### Generate lessons-learned.md
-Extract actionable wisdom from review documents into `codev/resources/lessons-learned.md`:
-1. Read all files in `codev/reviews/`
-2. Extract lessons that are:
-   - Actionable (not just "we learned X")
-   - Durable (still relevant)
-   - General (applicable beyond one project)
-3. Organize by topic (Testing, Architecture, Process, etc.)
-4. Link back to source review
-5. Prune outdated lessons
-**Template**:
-```markdown
-# Lessons Learned
-## Testing
-- [From 0001] Always use XDG sandboxing in tests to avoid touching real $HOME
-- [From 0009] Verify dependencies actually export what you expect
-## Architecture
-- [From 0008] Single source of truth beats distributed state
-- [From 0031] SQLite with WAL mode handles concurrency better than JSON files
-## Process
-- [From 0001] Multi-agent consultation catches issues humans miss
-```
-### Sync CLAUDE.md ↔ AGENTS.md
-Ensure both instruction files contain the same content:
-1. Diff the two files
-2. Identify divergence
-3. Update the stale one to match
-4. Both should be identical (per AGENTS.md standard)
-### Remove Dead Code
-Use static analysis to find and remove unused code:
-1. Run analysis tools (ts-prune, depcheck, ruff)
-2. Review findings for false positives
-3. Use `git rm` to remove confirmed dead code
-4. Commit with descriptive message
-**Important**: Use `git rm`, not `rm`. Git history preserves deleted files.
-### Update Dependencies
-Review and update outdated dependencies:
-1. Run `npm outdated` or equivalent
-2. Categorize updates:
-   - Patch: Safe to auto-update
-   - Minor: Review changelog
-   - Major: Requires human review for breaking changes
-3. Update and test
-4. Document any migration steps
----
-## Validation
-After completing tasks, validate the codebase:
-- [ ] All tests pass
-- [ ] Build succeeds
-- [ ] No import/module errors
-- [ ] Documentation links resolve
-- [ ] Linter passes
-If validation fails, investigate and fix before creating PR.
----
-## Rollback Strategy
-### For code changes
-```bash
-# Git history preserves everything
-git log --all --full-history -- path/to/file
-git checkout <commit>~1 -- path/to/file
-```
-### For untracked files
-Move to `codev/maintain/.trash/YYYY-MM-DD/` before deleting. Retained for 30 days.
----
-## Commit Messages
-```
-[Maintain] Remove 5 unused exports
-[Maintain] Update arch.md with new utilities
-[Maintain] Generate lessons-learned.md
-[Maintain] Sync CLAUDE.md with AGENTS.md
-[Maintain] Update dependencies (patch)
-```
----
-## Governance
-MAINTAIN is an **operational protocol**, not a feature development protocol:
-| Document | Required? |
-|----------|-----------|
-| Spec | No |
-| Plan | No |
-| Review | No |
-| Consultation | No (human review of PR is sufficient) |
-**Exception**: If MAINTAIN reveals need for architectural changes, those should follow SPIDER.
----
-## Best Practices
-1. **Don't be aggressive**: When in doubt, keep the code
-2. **Check git blame**: Understand why code exists before deleting
-3. **Run full test suite**: Not just affected tests
-4. **Group related changes**: One commit per logical change
-5. **Document decisions**: Note why things were kept or removed
----
-## Anti-Patterns
-1. **Deleting everything the audit finds**: Review each item
-2. **Skipping validation**: "It looked dead" is not validation
-3. **Using `rm` instead of `git rm`**: Lose history
-4. **Maintaining during active development**: Wait for PRs to merge
-5. **Ignoring false positives**: Fix audit logic if it's wrong

package/templates/protocols/spider/templates/plan.md DELETED Viewed

@@ -1,169 +0,0 @@
-# Plan: [Title]
-## Metadata
-- **ID**: plan-[YYYY-MM-DD]-[short-name]
-- **Status**: draft
-- **Specification**: [Link to codev/specs/spec-file.md]
-- **Created**: [YYYY-MM-DD]
-## Executive Summary
-[Brief overview of the implementation approach chosen and why. Reference the specification's selected approach.]
-## Success Metrics
-[Copy from specification and add implementation-specific metrics]
-- [ ] All specification criteria met
-- [ ] Test coverage >90%
-- [ ] Performance benchmarks achieved
-- [ ] Zero critical security issues
-- [ ] Documentation complete
-## Phase Breakdown
-### Phase 1: [Descriptive Name]
-**Dependencies**: None
-#### Objectives
-- [Clear, single objective for this phase]
-- [What value does this phase deliver?]
-#### Deliverables
-- [ ] [Specific deliverable 1]
-- [ ] [Specific deliverable 2]
-- [ ] [Tests for this phase]
-- [ ] [Documentation updates]
-#### Implementation Details
-[Specific technical approach for this phase. Include:
-- Key files/modules to create or modify
-- Architectural decisions
-- API contracts
-- Data models]
-#### Acceptance Criteria
-- [ ] [Testable criterion 1]
-- [ ] [Testable criterion 2]
-- [ ] All tests pass
-- [ ] Code review completed
-#### Test Plan
-- **Unit Tests**: [What to test]
-- **Integration Tests**: [What to test]
-- **Manual Testing**: [Scenarios to verify]
-#### Rollback Strategy
-[How to revert this phase if issues arise]
-#### Risks
-- **Risk**: [Specific risk for this phase]
-  - **Mitigation**: [How to address]
----
-### Phase 2: [Descriptive Name]
-**Dependencies**: Phase 1
-[Repeat structure for each phase]
----
-### Phase 3: [Descriptive Name]
-**Dependencies**: Phase 2
-[Continue for all phases]
-## Dependency Map
-```
-Phase 1 ──→ Phase 2 ──→ Phase 3
-             ↓
-         Phase 4 (optional)
-```
-## Resource Requirements
-### Development Resources
-- **Engineers**: [Expertise needed]
-- **Environment**: [Dev/staging requirements]
-### Infrastructure
-- [Database changes]
-- [New services]
-- [Configuration updates]
-- [Monitoring additions]
-## Integration Points
-### External Systems
-- **System**: [Name]
-  - **Integration Type**: [API/Database/Message Queue]
-  - **Phase**: [Which phase needs this]
-  - **Fallback**: [What if unavailable]
-### Internal Systems
-[Repeat structure]
-## Risk Analysis
-### Technical Risks
-| Risk | Probability | Impact | Mitigation | Owner |
-|------|------------|--------|------------|-------|
-| [Risk 1] | L/M/H | L/M/H | [Strategy] | [Name] |
-### Schedule Risks
-| Risk | Probability | Impact | Mitigation | Owner |
-|------|------------|--------|------------|-------|
-| [Risk 1] | L/M/H | L/M/H | [Strategy] | [Name] |
-## Validation Checkpoints
-1. **After Phase 1**: [What to validate]
-2. **After Phase 2**: [What to validate]
-3. **Before Production**: [Final checks]
-## Monitoring and Observability
-### Metrics to Track
-- [Metric 1: Description and threshold]
-- [Metric 2: Description and threshold]
-### Logging Requirements
-- [What to log and at what level]
-- [Retention requirements]
-### Alerting
-- [Alert condition and severity]
-- [Who to notify]
-## Documentation Updates Required
-- [ ] API documentation
-- [ ] Architecture diagrams
-- [ ] Runbooks
-- [ ] User guides
-- [ ] Configuration guides
-## Post-Implementation Tasks
-- [ ] Performance validation
-- [ ] Security audit
-- [ ] Load testing
-- [ ] User acceptance testing
-- [ ] Monitoring validation
-## Expert Review
-**Date**: [YYYY-MM-DD]
-**Model**: [Model consulted]
-**Key Feedback**:
-- [Feasibility assessment]
-- [Missing considerations]
-- [Risk identification]
-- [Alternative suggestions]
-**Plan Adjustments**:
-- [How the plan was modified based on feedback]
-## Approval
-- [ ] Technical Lead Review
-- [ ] Engineering Manager Approval
-- [ ] Resource Allocation Confirmed
-- [ ] Expert AI Consultation Complete
-## Change Log
-| Date | Change | Reason | Author |
-|------|--------|--------|--------|
-| [Date] | [What changed] | [Why] | [Who] |
-## Notes
-[Additional context, assumptions, or considerations]