# Place Node

> Partial Skill: invoke by name only — project-spec/place-node's engine that suggests a capability home and surfaces duplicates for a new node — used by explore, not triggered by users directly.

- Skill: `cyberuni/place-node` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add cyberuni/place-node`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cyberuni/place-node/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cyberuni (https://skillmd.com/u/cyberuni)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cyberuni/place-node

---


# Place Node

The concrete engine for the **place-node** step. Given a new
node's `concept` (and optional name), it suggests a **provisional** capability home and catches possible
duplicates, so explore places a node without holding the whole tree in its head (it scans the project-spec's
`concept:` frontmatter and ranks the capability folders those facets already sit in). Self-contained `.mts`
(the repo's node-≥23.6 / no-deps convention).

## Run it

```bash
node "<skill>/scripts/place-node.mts" --spec-dir <spec> --concept <c> [--name <n>]
```

- `--concept` — suggests the capability folders where that concept's facets already sit, ranked by count
  (the provisional home). A concept no node yet carries → an empty suggestion: pick any plausible
  capability, finalized at handoff.
- `--name` — surfaces existing nodes whose path overlaps the name ("belongs near X" duplicate-catch).

The home is **derived** from the project-spec's own `concept:` tags — where that concept's facets
already sit — never a stored routing list (the `corpus/discovery` no-drift rule). For genuinely
contested overlaps, the human tie-break rules live in the placement-map routing table (root
`spec.md`), which this tool points to rather than re-deriving.

**Strategy-neutral by construction — and not this tool's call.** The derivation follows the tree as
it actually is, so it returns a correctly-shaped home under whatever layout the project declared: a
`mirror-source` project's concepts sit in mirror-shaped folders, and "where the siblings already
are" answers that as well as it answers capability-first. This tool therefore neither reads nor
recommends a strategy. Choosing one belongs to `scaffold-project-spec`, recording it to the root
`spec.md` placement map, and judging fit against it to the formation Warden
(`sdd:spec-structure-governance`).

## Boundaries

Read-only and advisory — it **writes nothing** (no scaffold, no relocation, no frontmatter); placement is
provisional and finalized at handoff (the `start-mission` handoff step), so a
suggestion never has to be correct — only useful. Frontmatter only — no node body is read. When `node` is
absent, an agent does the same by hand: read the `concept:` tags, see where that concept already lives,
and place near them.

