๐ค AgentStack โ Project Instructions
Purpose: Design and evolve the agent/harness/memory architecture that runs this vault โ "Hermes." Two distinct workflows live here: (1) drafting and reviewing agent/harness specs, (2) scouting reusable skills out of recurring work. See AgentStack/README for the one-line mission; this file is the how.
Workflow 1 โ Harness & Agent Spec Design
Where architectural decisions about the agent stack itself get designed: agent roles, pipelines, memory taxonomy, model/effort routing.
Triggers
Draft harness spec: [topic]
Example: Draft harness spec: nightly scheduler redesign
Design agent: [role]
Example: Design agent: WIKI-CONSOLIDATION-AGENT retry behavior
Review spec: [name]
Example: Review spec: hermes-harness-spec
Update memory architecture
Structure to Follow
Calibrate against hermes-harness-spec as the reference example:
- Frontmatter includes a
status:field (draft/core-decisions-locked/implemented) - Opens with why change anything โ state the problem before the design
- Pipeline/role tables: cadence, reads, writes, model/effort
- A numbered open questions section โ don't silently resolve ambiguity, flag it
- A dated decisions section logging what was settled in each review pass, not just the final state
- Write output to
AgentStack/Agents/<slug>.md, and add it toAgentStack/Agents/_index.md
Model / Effort Pinning
Reuse the pinning already decided in hermes-harness-spec ยง9 unless a new spec has a specific reason to deviate: Haiku 4.5 for mechanical/deterministic passes, Sonnet 5 for mid-tier reasoning agents, Opus 4.8 for the highest-judgment roles (knowledge graduation, archival compaction).
Workflow 2 โ Skill Scouting
The interactive form of SKILL-SCOUT-AGENT (hermes-harness-spec ยง2): find recurring procedures across the vault's work that are worth turning into a reusable, named skill.
Trigger
Scout skills
Scout skills โ [folder or topic]
Processing Rules
- Look for a procedure repeated โฅ2ร across sessions or files โ a one-off doesn't qualify.
- Draft the skill into
AgentStack/Skills/.drafts/<slug>.mdโ never write directly intoAgentStack/Skills/from this workflow. - Promotion from
.drafts/toAgentStack/Skills/is WIKI-CONSOLIDATION-AGENT's call, not this workflow's โ see wiki/system_prompt. Skip quiet sessions: if nothing recurred, don't force a draft.