Summary

Add a project-manager optional skill that solves the fundamental tension between AI agents' stateless nature and projects' need for continuity. Each project gets its own STATUS.md file, enabling seamless context recovery across sessions without polluting global memory.

Problem

AI agents are stateless — each conversation starts fresh. But real work spans multiple sessions:

• Memory explosion: All project progress stuffed into MEMORY.md → 1000+ lines, slow retrieval
• Context pollution: Project A's progress leaks into Project B's context
• Lost breakpoints: "Continue last project" → agent doesn't know which one or where it left off
• Over-engineering: Tiny tasks forced into full project templates

Solution

A per-project STATUS.md system — the agent's "external hard drive":

workspace/projects/
├── index.md              # Auto-maintained project registry
├── {project-name}/
│   └── STATUS.md         # Progress, todos, key decisions
└── _archive/             # Completed/abandoned projects

Key Features

Quantified Impact

Compatibility

• Designed as an optional skill — not activated by default
• Compatible with Hermes' existing memory system (complementary, not conflicting)
• No breaking changes to existing Hermes architecture
• Tested across concurrent agent instances (Feishu, WeChat, CLI channels)

Files Added

optional-skills/project-manager/
├── SKILL.md              # Skill definition (agent instructions)
└── references/
    └── templates.md      # STATUS.md templates (Full A + Lightweight B)

v2.2 — Battle-tested across multiple concurrent agent sessions with auto-healing index, write-safe updates, and fuzzy-match fallback.