agileflow 3.3.0 → 3.4.1

package/src/core/experts/mentor/expertise.yaml

@@ -111,42 +111,15 @@ conventions:
   - "Research notes inform epic planning"
   - "NO AI attribution in commits (per CLAUDE.md)"
 
-agent_roster:
-  - id: AG-UI
-    scope: "Frontend, components, styling, accessibility"
-  - id: AG-API
-    scope: "Backend, endpoints, business logic, database"
-  - id: AG-CI
-    scope: "Test infrastructure, pipelines, quality tools"
-  - id: AG-DEVOPS
-    scope: "Deployment, dependencies, technical debt, release process"
-  - id: EPIC-PLANNER
-    scope: "Epic/story decomposition"
-  - id: ADR-WRITER
-    scope: "Architecture decisions"
-  - id: RESEARCH
-    scope: "Technical research"
-  - id: MENTOR
-    scope: "End-to-end guidance (babysit)"
-
-# Learned from AgileFlow codebase exploration
-learnings:
-  - date: 2025-12-21
-    context: "Analyzed babysit workflow"
-    insight: "Babysit command guides from 'What to work on?' through story creation, agent spawning, verification, and commit"
-    source: "packages/cli/src/core/commands/babysit.md"
-
-  - date: 2025-12-21
-    context: "Analyzed status.json structure"
-    insight: "Tracks epics (title, status, completed, summary) and stories (owner, status, priority, estimate, depends_on, test_status)"
-    source: "docs/09-agents/status.json"
+# Agent roster: AG-UI, AG-API, AG-CI, AG-DEVOPS, EPIC-PLANNER, ADR-WRITER, RESEARCH, MENTOR
+# (details in babysit.md delegation framework - omitted here)
 
+# Learnings (trimmed - keep 2 most actionable)
+learnings:
   - date: 2025-12-21
-    context: "Analyzed Agent Expert system"
-    insight: "25 domain experts with expertise.yaml, question.md, self-improve.md, workflow.md; agents load expertise first before tasks"
-    source: "packages/cli/src/core/experts/"
+    context: "Babysit workflow"
+    insight: "Guides from task selection through story creation, agent spawning, verification, and commit. Status.json tracks epics + stories."
 
   - date: 2025-12-21
-    context: "Analyzed auto-archival system"
-    insight: "scripts/archive-completed-stories.sh moves done stories >7 days old to archive/YYYY-MM.json; runs on session start"
-    source: "CLAUDE.md, scripts/archive-completed-stories.sh"
+    context: "Agent Expert system"
+    insight: "26 domain experts with expertise.yaml, question.md, self-improve.md, workflow.md. Agents load expertise first before tasks."

package/src/core/experts/monitoring/expertise.yaml

@@ -119,56 +119,14 @@ conventions:
   - "Set retention policies for logs and metrics"
   - "Test alerts in staging before production"
 
-log_levels:
-  ERROR: "Service unavailable, data loss, requires immediate attention"
-  WARN: "Degraded behavior, unexpected but handled, investigate soon"
-  INFO: "Important state changes, deployments, audit events"
-  DEBUG: "Detailed diagnostic info, development only"
-
-metric_types:
-  counter: "Cumulative value (requests_total, errors_total)"
-  gauge: "Current value (active_connections, queue_size)"
-  histogram: "Distribution (request_duration, response_size)"
-  summary: "Quantiles (p50, p90, p99 latency)"
-
-slo_targets:
-  availability: "99.9% (8.7 hours downtime/year)"
-  latency_p50: "<100ms"
-  latency_p95: "<200ms"
-  latency_p99: "<500ms"
-  error_rate: "<0.1%"
-
-# Learnings are AUTO-UPDATED by self-improve.md
-# Do not edit manually - let the agent learn from experience
-learnings:
-  - date: 2025-12-21
-    context: "AgileFlow monitoring patterns"
-    learning: |
-      Session hooks run on SessionStart via .claude/settings.json hooks configuration.
-      The default SessionStart hook executes 'node .agileflow/scripts/get-env.js' to display
-      project info, git status, and system details at session start. This provides
-      immediate context about the development environment.
-
-  - date: 2025-12-21
-    context: "AgileFlow status line implementation"
-    learning: |
-      Status line shows real-time project context in Claude Code status bar via
-      scripts/agileflow-statusline.sh. Components include: git branch (color-coded),
-      current story from status.json, WIP count (yellow if >1, red if >3), and
-      completion percentage. This provides at-a-glance project health visibility.
+# Log levels, metric types, SLO targets: generic observability knowledge (models know - omitted)
 
+# Learnings (trimmed - keep 2 most actionable)
+learnings:
   - date: 2025-12-21
-    context: "AgileFlow agent activity logging"
-    learning: |
-      Agent communication is logged to docs/09-agents/bus/log.jsonl in append-only
-      format. Each entry is a JSON line with timestamp, agent_id, message_type, and
-      payload. This enables audit trails and debugging of multi-agent workflows
-      without corrupting the log file with concurrent writes.
+    context: "Session hooks and status line"
+    insight: "SessionStart hooks in .claude/settings.json. Status line via agileflow-statusline.sh shows git branch, current story, WIP count, completion %."
 
   - date: 2025-12-21
-    context: "AgileFlow validation script patterns"
-    learning: |
-      Validation scripts (e.g., scripts/validate-*.sh) output PASS/WARN/FAIL status
-      codes with colored output for health checks. Scripts validate configuration,
-      file structure, and dependencies. Exit code 0 = all checks passed, non-zero =
-      failures detected. This standardized format enables automated CI/CD integration.
+    context: "Agent activity logging"
+    insight: "docs/09-agents/bus/log.jsonl: append-only JSON Lines with timestamp, agent_id, message_type, payload. Never edit existing lines."

package/src/core/experts/performance/expertise.yaml

@@ -35,36 +35,11 @@ relationships:
     target: "<50ms p95"
     measurement: "Query profiling"
 
-patterns:
-  - name: N+1 Query Fix
-    description: "Batch queries instead of loop"
-    detection: "Multiple similar queries in sequence"
-  - name: Caching Layer
-    description: "Cache expensive computations"
-    types: [memory, redis, cdn]
-  - name: Lazy Loading
-    description: "Load resources on demand"
-    applies_to: [images, modules, routes]
-  - name: Database Indexing
-    description: "Add indexes for slow queries"
-    detection: "EXPLAIN shows table scan"
+# Generic perf patterns (N+1, caching, lazy loading, indexing) omitted - models know these
 
 conventions:
   - "Profile before optimizing (no premature optimization)"
   - "Measure before and after every change"
-  - "Set performance budgets in CI"
-  - "Document performance trade-offs"
-  - "Monitor production performance continuously"
-  - "Alert on performance regressions"
-
-bottlenecks:
-  common:
-    - "Unindexed database queries"
-    - "N+1 query patterns"
-    - "Large bundle sizes"
-    - "Unoptimized images"
-    - "Missing caching"
-    - "Synchronous operations"
 
 learnings:
   - date: 2025-12-21

package/src/core/experts/security/expertise.yaml

@@ -29,8 +29,6 @@ files:
     - path: .npmrc
       purpose: "npm token (GITIGNORED - never commit)"
       note: "Contains NPM_TOKEN for publishing"
-    - path: .mcp.json
-      purpose: "MCP secrets (GITIGNORED)"
     - path: .env
       purpose: "Environment secrets (GITIGNORED)"
 
@@ -39,7 +37,6 @@ files:
       purpose: "Ensures sensitive files are not committed"
       sensitive_patterns:
         - ".npmrc"
-        - ".mcp.json"
         - ".env"
         - "CLAUDE.md (internal docs)"
 
@@ -66,7 +63,7 @@ relationships:
     files: [src/lib/crypto.ts]
   - component: secrets
     storage: "GitHub Secrets for CI, local gitignored files"
-    files: [".npmrc", ".mcp.json", ".env"]
+    files: [".npmrc", ".env"]
 
 patterns:
   - name: JWT with Refresh Tokens
@@ -86,7 +83,7 @@ patterns:
   - name: Gitignored Secrets
     description: "Local secret files excluded from version control"
     location: ".gitignore"
-    files: [".npmrc", ".mcp.json", ".env", "CLAUDE.md"]
+    files: [".npmrc", ".env", "CLAUDE.md"]
 
   - name: No Hardcoded Secrets
     description: "Never commit tokens, passwords, or API keys"
@@ -104,39 +101,17 @@ conventions:
   - "HTTPS required in production"
   - "Security headers: HSTS, CSP, X-Frame-Options"
   - "Store CI secrets in GitHub Secrets (NPM_TOKEN)"
-  - "Gitignore sensitive files (.npmrc, .mcp.json, .env)"
+  - "Gitignore sensitive files (.npmrc, .env)"
   - "Warn user if they try to commit credentials files"
 
-owasp_top_10:
-  - "A01: Broken Access Control"
-  - "A02: Cryptographic Failures"
-  - "A03: Injection"
-  - "A04: Insecure Design"
-  - "A05: Security Misconfiguration"
-  - "A06: Vulnerable Components"
-  - "A07: Authentication Failures"
-  - "A08: Data Integrity Failures"
-  - "A09: Logging Failures"
-  - "A10: SSRF"
+# OWASP top 10 omitted - models know this standard
 
-# Learned from AgileFlow codebase exploration
+# Learnings (trimmed - keep 2 most actionable)
 learnings:
   - date: 2025-12-21
-    context: "Analyzed AgileFlow secret management"
-    insight: "NPM_TOKEN stored in GitHub Secrets for CI; local .npmrc gitignored; never commit tokens"
-    source: "CLAUDE.md, .github/workflows/npm-publish.yml"
+    context: "Secret management"
+    insight: "NPM_TOKEN in GitHub Secrets for CI. Gitignored: .npmrc, CLAUDE.md. Never commit tokens."
 
   - date: 2025-12-21
-    context: "Analyzed gitignored sensitive files"
-    insight: ".npmrc, .mcp.json, CLAUDE.md are gitignored to prevent accidental secret commits"
-    source: ".gitignore"
-
-  - date: 2025-12-21
-    context: "Analyzed CI secrets pattern"
-    insight: "GitHub Actions uses secrets.NPM_TOKEN for npm publish; workflow verifies package version matches tag before publishing"
-    source: ".github/workflows/npm-publish.yml"
-
-  - date: 2025-12-21
-    context: "Analyzed commit guidelines"
-    insight: "CLAUDE.md explicitly states: do not commit files that likely contain secrets (.env, credentials.json); warn user if requested"
-    source: "CLAUDE.md"
+    context: "Commit security"
+    insight: "CLAUDE.md forbids committing .env, credentials.json. Warn user if they request it. No AI attribution in commits."

package/src/core/experts/ui/expertise.yaml

@@ -91,25 +91,7 @@ patterns:
     location: Component file top
     convention: "interface ComponentNameProps"
 
-  - name: "forwardRef"
-    description: "Forward refs for DOM access and composition"
-    location: Base components
-    use_case: "When component wraps native element"
-
-  - name: "Styling with Tailwind"
-    description: "Utility-first CSS with Tailwind classes"
-    location: className prop
-    helper: "cn() for conditional classes"
-
-  - name: "Class Variance Authority (CVA)"
-    description: "Type-safe component variants"
-    location: src/components/ui/
-    use_case: "Components with multiple variants"
-
-  - name: "Accessibility"
-    description: "WCAG 2.1 AA compliance, ARIA attributes"
-    location: Interactive components
-    requirements: [keyboard-nav, screen-reader, focus-visible]
+  # Generic React patterns (forwardRef, Tailwind, CVA, a11y) omitted - models know these
 
   - name: "CLI Colored Output"
     description: "Use chalk for terminal colors with semantic meaning"
@@ -140,24 +122,12 @@ conventions:
   - "CLI colors: chalk with semantic colors (green=success, red=error, yellow=warn)"
   - "CLI prompts: inquirer with validation functions"
 
-# Learned from AgileFlow codebase exploration
+# Learnings (trimmed - keep 2 most actionable)
 learnings:
   - date: 2025-12-21
-    context: "Analyzed AgileFlow CLI UI patterns"
-    insight: "CLI uses chalk for colored output with brand color #e8683a; semantic colors: green=success, yellow=warning, red=error, dim=info"
-    source: "packages/cli/tools/cli/lib/ui.js"
+    context: "CLI UI patterns"
+    insight: "chalk for colors (brand #e8683a, green=success, yellow=warning, red=error, dim=info). inquirer for prompts (input, checkbox, confirm)."
 
   - date: 2025-12-21
-    context: "Analyzed CLI interactive prompts"
-    insight: "Uses inquirer.prompt() with input, checkbox, confirm types; includes validation functions for user input"
-    source: "packages/cli/tools/cli/lib/ui.js"
-
-  - date: 2025-12-21
-    context: "Analyzed ASCII logo pattern"
-    insight: "displayLogo() renders Unicode block-style ASCII art with brand color; shows version from package.json"
-    source: "packages/cli/tools/cli/lib/ui.js"
-
-  - date: 2025-12-21
-    context: "Analyzed IDE choices UI"
-    insight: "IDE_CHOICES array with name, value, checked, configDir, description for checkbox prompts"
-    source: "packages/cli/tools/cli/lib/ui.js"
+    context: "CLI logo and IDE choices"
+    insight: "displayLogo() renders brand art with version. IDE_CHOICES array for checkbox prompts with name, value, checked, configDir."