Phase 1-3: Add memory, skills, and improvement systems

- memory/: cross-session project memory with decisions, lessons, failures,
  architecture, and sessions categories. Each has format templates and
  lifecycle documentation.
- skills/: 12 reusable specialized methodologies (tdd, systematic-debugging,
  architecture-design, code-review, security-review, repository-analysis,
  failure-analysis, refactoring, test-analysis, incident-investigation,
  browser-automation, research). Each has frontmatter and methodology sections.
- improvements/: proposal-based improvement system requiring human approval.
- scripts/memory-lifecycle.sh: deterministic memory operations (recall, store,
  list, search, sessions, cleanup).
- scripts/test-memory-system.sh: 12 structural tests for all new systems.
- orchestrator.md: added Memory Recall stage, Learning and Memory Storage
  stage, Improvement Proposals workflow, memory/skills rules, and 3 new
  actions (A23-A27) to the action catalog. Updated behavioral acceptance test
  and state separation model.
- All 12 subagents: added Memory & Skills Awareness sections with recall
  and store instructions.
- docs/AGENT_ARCHITECTURE.md: documented memory, skills, and improvements
  systems (sections 12-14). Updated action count (27), state model, and
  remaining weaknesses.
- README.md: documented new systems, updated repository layout, added
  test-memory-system.sh documentation.

All 39 tests pass (16 architecture + 12 memory + 11 bootstrap).
This commit is contained in:
Your Name
2026-09-08 04:31:40 -04:00
parent fb9d91e510
commit 2dabf8ef03
38 changed files with 2247 additions and 22 deletions
+68
View File
@@ -0,0 +1,68 @@
---
name: repository-analysis
description: Systematic repository exploration — understanding codebase structure, patterns, and conventions
version: "1.0"
owner: Explorer
prerequisites: repo access
---
# Repository Analysis
## When to use this skill
- First encounter with a repository
- Understanding a new area of a familiar repository
- Before architectural or implementation decisions
## Step-by-step procedure
### 1. Orientation
- Read README, package.json/pyproject.toml, or equivalent
- Identify the project's purpose, language, and framework
- Note the top-level structure
### 2. Entry points
- Find the main entry points (main, index, app)
- Trace the execution flow from entry to key functionality
- Identify the public API surface
### 3. Structure
- Map the directory structure to logical components
- Identify module boundaries and dependencies
- Note naming conventions
### 4. Build & test
- Identify the build system and commands
- Find the test suite and how to run it
- Check for linting, type-checking, CI configuration
### 5. Conventions
- Note coding style (formatting, naming, patterns)
- Identify architectural patterns (MVC, layered, etc.)
- Check for existing documentation of conventions
### 6. Dependencies
- Review external dependencies
- Note version constraints and lock files
- Identify any custom or vendored dependencies
## Common pitfalls
- Exploring too broadly (lost in the codebase)
- Not recording findings (have to re-explore)
- Confusing what exists with what is intended
- Not distinguishing generated from hand-written code
- Ignoring test files (they reveal intent)
## Evidence requirements
- File:line references for key findings
- Confidence levels for uncertain findings
- Questions for follow-up investigation
## Exit criteria
- System map with key files and their roles
- Confidence levels for each finding
- Open questions listed
- Findings recorded in report