adaptogen-build-new
You are in the adaptogen-build-new state of the adaptogen DAG, always
entered from adaptogen-orient when no SKILL.md exists yet at the
target location. This skill is self-contained.
What must hold here, always
- A skill drafted from a guess and never run is unverified by
construction --
adaptogen-build-newis never a terminal state on its own. It always continues toadaptogen-run. - Every skill you write here -- whether a single skill or a DAG of
several -- must be independently agentskills.io-compliant: a real
directory containing
SKILL.mdwith valid frontmatter (namefield matching the directory name exactly, lowercase-hyphen-only, no consecutive hyphens; non-emptydescription), Markdown body, optionalscripts//references//assets/subdirectories only for genuinely optional supplementary material -- never for control flow an agent must hop through to have working instructions. - The drafted skill follows this same DAG-of-skills convention when (and
only when) the task genuinely calls for multiple states: a router
SKILL.mdnaming sibling skills and the legal transitions between them, each sibling itself a real, independent, self-contained skill directory (<parent-name>-<state>naming), the same shape as this DAG itself. Do not invent states the task doesn't need -- a task with one real step is one skill, not a router plus one satellite.
Do this
- Decide scope: does this task need more than one state? If the procedure has no real branch, loop, or regression -- just a straight sequence a single skill's body can hold under ~500 lines -- write one skill and stop here (skip the DAG entirely). If it has genuine states with different concerns and transitions between them, proceed as a DAG.
- For a single skill: write
<dir>/SKILL.mddirectly -- frontmatter, then instructions, examples, edge cases, per agentskills.io's recommended body sections. - For a DAG: write the router
<dir>/SKILL.md(state map, Entry pointing at the first sibling skill, Hard Rules that bind across every state), then write each<dir>-<state>/SKILL.mdas its own real, independently-discoverable skill: what must hold in that state, what to do, and explicit transitions naming which sibling skill(s) toSkill()-dispatch next and under what condition -- same shape as this DAG's own state-skills. - This draft is not run yet and not committed yet; it is the "target"
that
adaptogen-runwill exercise for real next.
Transition
- Skill (or DAG of skills) drafted -> dispatch
Skill(skill="adaptogen-run")now, treating the new skill exactly like any other target entering the machine for the first time. State explicitly: the resolved absolute path to the new skill's (or DAG's router's)SKILL.md, and confirmation this is a build pass (soadaptogen-run's dispatch task is built from the drafted skill's own stated purpose, since it has no prior usage history to draw a task from). - No other transition exists from this state.