first-tree-synclisted
Install: claude install-skill agent-team-foundation/first-tree
# First Tree Sync
Read these first:
- `../first-tree/SKILL.md`
- `../first-tree/references/functions.md`
- `../first-tree/references/maintenance.md`
## What This Skill Does
Compare a Context Tree against the source repo(s) it describes in **both
directions**:
- **tree→code** — for each tree node, does the code still support it?
(catches `tree-stale`, `tree-wrong`, `tree-outdated`, `cross-domain-broken`,
`ownership-stale`)
- **code→tree** — for each piece of source structure, does the tree
register it? (catches `code-not-synced`)
Classify every gap, then route each finding to auto-fix, hand-off-to-write,
needs-human, or skip.
Two phases, in order:
1. **audit** — produce a `drifts[]` list. Read-only, human-paced. Combines
a tree→code pass (Phase 1–3) with a code→tree sweep (Phase 4).
2. **fix** — for each drift, decide auto-fix / write-handoff / needs-human
/ skip and act on that decision.
Each phase has a dedicated reference; follow them in order.
## When To Use This Skill
| Use this skill | Use a different skill |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------ |
| User asks "is the tree up to date?" | User has a specific PR / doc to reflect into the tree → `first-tree-write` |
| Audit drift since a release | R