Odin Codin' — captured source docs
Captured during the Yggdrasil restructure (the execution-partner-layer fold-in, subproject I). The
odin-codinrepo is not on this host, and these two files plus empty skeleton dirs are the entire substance of Odin Codin'. Preserved here so the fold-in content work survives/clear. Seeworking/yggdrasil-restructure-design.md→ subproject I.
odin-codin/AGENTS.md (verbatim)
# Agents working in this repo
This is **Odin Codin'**, a code-crawling workflow that composes on top of
Yggdrasil. See [README.md](README.md) for the full philosophy.
## Orientation
- **Not a target codebase.** Don't look for application code here.
- **Not self-contained.** Composes with Yggdrasil (substrate) and the
personal layer. See README for the layering scheme.
- **Skeleton stage.** Most directories are intentionally empty pending
Phases 5-7 of the implementation plan.
## What this repo contains
| Directory | Purpose | Status |
| --- | --- | --- |
| `skills/` | Methodology skills | empty (Phase 5) |
| `agents/` | Subagent definitions | empty (Phase 6) |
| `commands/` | Slash commands | empty (Phase 6) |
| `templates/` | Output scaffolds | empty (Phase 7) |
| `.meta/workflow.yaml` | Workflow metadata + dependency declaration | present |
## Conventions
- **Skill names:** gerund form (`code-crawling`, `decomposition`).
- **Command names:** imperative (`/crawl-branch`, `/recap`).
- **Skill descriptions:** third-person; include both *what* the skill does
and *when* to use it.
- **Subagents:** follow Claude/Anthropic conventions.
- **Norse-mythology naming** where it adds flavor: Hugin (thought-side
agents) and Munin (memory-side persistence). Not forced.
## For deeper context
- [README.md](README.md) -- this repo
- [../yggdrasil/README.md](../yggdrasil/README.md) -- substrate layer
- [../yggdrasil/working/current-plan.md](../yggdrasil/working/current-plan.md) -- live implementation plan
odin-codin/README.md (verbatim)
# Odin Codin'
Code-crawling workflow. Composes on top of [Yggdrasil](../yggdrasil/).
In Norse mythology, Odin sends his ravens Hugin (thought) and Munin (memory)
out across the world each day to bring back what they see. That's the split
this workflow uses: Hugin-side agents do the active reading and reasoning;
Munin-side memory captures and persists what was learned, so future passes
don't redo work.
## What it's for
Going through unfamiliar codebases branch by branch, building durable
understanding artifacts that aren't trapped in chat history. Designed
around the human-in-the-loop discipline: the workflow proposes, the human
confirms, the artifacts are reviewable and committable.
Initial target: FFXI / LandSandBoat-shaped repos. The methodology is meant
to generalize.
## Layout
odin-codin/
|-- README.md (this file)
|-- AGENTS.md (entry point for non-Claude agents)
|-- .meta/
| `-- workflow.yaml (declares dependency on Yggdrasil)
|-- skills/ (methodology -- how to crawl)
|-- agents/ (Hugin-side workers)
|-- commands/ (ergonomic shortcuts)
`-- templates/ (output scaffolds)
## Composition
This is a *workflow* in the layered scheme described in
[Yggdrasil's README](../yggdrasil/README.md). It depends on Yggdrasil for
substrate primitives (`bookmarking`, `learning-new-skills`, the `.meta/`
pattern). Workflow-specific skills live here; if something proves general
across multiple workflows, it gets promoted to Yggdrasil.
Symlinks into `~/.claude/` are configured per-machine. See
`new-machine-setup` for the procedure.
## Status
Skeleton only. No skills, agents, or commands implemented yet -- those land
in Phases 5-7 (see [Yggdrasil's current-plan.md](../yggdrasil/working/current-plan.md)).