chore: Hermes research docs + ORCHESTRATION log + .codegraph gitignore

[webdevtodayjason]

Summary

Three housekeeping commits, all docs / config only:

1. 42cdbe9 docs: capture Hermes compact + skill-loading mechanism findings
   Research artifact in .subctl/docs/hermes-compact-and-skills-findings.md for v4 Evy bootstrap planning. Documents Hermes' LLM-driven compact (threshold = max(50% × ctx, 64K floor)) and progressive-disclosure skill loading via system-prompt index + skill_view tool. Authored by @webdevtodayjason on the prior research push.

2. d8d92d0 docs(orchestration): log 2026-05-28 claude-teams unblock session
   ORCHESTRATION.md entry for the PR fix: unblock claude-teams (PATH shim + master→evy import rename leftovers) #38 work — root cause, fixes, validation, decision log. Keeps the orchestration history sequential.

3. 1f39411 chore(gitignore): ignore .codegraph/ MCP index dir
   CodeGraph MCP (installed via npx @colbymchenry/codegraph) drops a sqlite index + daemon scratch at .codegraph/. Local state, not source-of-truth.

Test plan

• Zero code changes; pure docs + .gitignore. No test coverage required.
• Branch rebased cleanly onto current main; the two fix commits from PR fix: unblock claude-teams (PATH shim + master→evy import rename leftovers) #38 were auto-dropped via patch-id detection during rebase.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Chores

  • Updated the local development environment configuration to exclude code analysis indices and build artifacts from tracking.

• Documentation

  • Added comprehensive new documentation for system operators covering LLM-driven mechanisms including context management and summarization strategies, skill-based system behaviors, system orchestration and coordination, plus incident response procedures and operational logs.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 5a8fbf7c-0e0c-4a7f-bbe7-c86ff1624606

📥 Commits

Reviewing files that changed from the base of the PR and between 837a808 and 1f39411.

📒 Files selected for processing (3)

• .gitignore
• .subctl/docs/hermes-compact-and-skills-findings.md
• ORCHESTRATION.md

Disabled knowledge base sources:

• Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.

---

📝 Walkthrough

Walkthrough

PR adds CodeGraph MCP index to gitignore, introduces comprehensive Hermes mechanisms research documentation detailing context compacting and skill-loading with Evy v3/v4 porting guidance, and logs an orchestration incident for a claude-teams unblock resolution with root causes and verification steps.

Changes

Documentation and Configuration Updates

Layer / File(s)	Summary
CodeGraph MCP index gitignore \.gitignore	.codegraph/ entry excludes local CodeGraph MCP index scratch directory.
Hermes mechanisms research documentation \.subctl/docs/hermes-compact-and-skills-findings\.md	New operator-focused document describing Hermes' context-compacting mechanism (token-driven thresholding, pruning, boundary detection, auxiliary-model summarization, reassembly with special abort/anti-thrash behaviors) and skill-loading mechanism (system-prompt index routing to LLM-driven skill_view tool with three entry paths: autonomous, slash-command, and channel-bound). Includes detailed semantics, implementation notes for Evy v3 (TypeScript) and v4 (Rust) with threshold constants, trigger wiring, and conceptual pipeline adaptation, plus open questions on "approach" semantics, session-DB mutation, auxiliary-model failures, multi-round compacting effects on skills, and scope boundaries.
Orchestration incident log entry ORCHESTRATION\.md	Session log for 2026-05-28 claude-teams unblock incident: documents two root causes (v4 subctl PATH collisions with v3 dispatcher shims, stale components/master/... imports after rename), lists two shipped fix commits, records dry-run verification and module import resolution, captures decision log, and enumerates follow-ups on PR push and install tree reconciliation.

🎯 1 (Trivial) | ⏱️ ~4 minutes

🐰 A doc and config tale so light,
Where Hermes' compact shines so bright,
Skills route and compress with care,
An incident resolved with flair,
And gitignore keeps the index fair! ✨

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/hermes-research

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}