- Docs
- Hand an intent to build
Hand an intent to build
Hand a shaped intent to Core intake so it can select the right repository-work route without losing its boundaries or provenance.
Use this when: A shaped intent is ready to become repository work.
Prerequisites: product-engineering and core packs installed; a shaped intent with a confirmed outcome and boundaries.
Result: A Core intake route that preserves the handoff context and stops at the next required approval gate.
Your shaping work has named the outcome and boundaries. Start the Core handoff with them intact:
Start this shaped intent through Core intake: workspace owners need export retention controls, with the confirmed outcome and boundaries preserved.Core’s work-intake writes the canonical artifact, registers it in
workspace.toml, and reports the route. It dispatches a processor only after
both writes succeed.
Choose the route
Section titled “Choose the route”- One independently shippable feature goes to
new-spec. - A coherent outcome that needs several specs or repositories goes to
author-delivery-brief create. - A cited regression goes to
bug-fix.
If the work only needs minimum repository admission before a solution artifact
is selected, Core uses intake-intent. That route creates or updates the
repository intent and stops after admission; it does not begin delivery work.
When your shaped intent already sits at the destination path, admission accretes: Core adds the fields routing needs — status, boundary, owner, unresolved questions, projection, and source — to that artifact in place, and keeps the framing you wrote, including its altitude. It does not re-render the file or restate your outcome.
Carry the architecture with it
Section titled “Carry the architecture with it”If you shaped an architecture concept or design doc, it goes with the intent.
When intent decompose cuts a feature the design covers, it carries the
design’s location in the delivery contract’s design context, and new-spec
reads it there when it writes the plan’s design section. To make the spec wait
until the design lands, register the design in workspace.toml and add it to
the spec’s needs array. That entry only orders the work. If your repository has a reference.md, the plan follows
it without any extra step.
Keep the gates
Section titled “Keep the gates”The handoff supplies bounded context and provenance. It does not approve an artifact or skip a human gate, so continue only when Core shows the next route and its required approval.
What you have now
Section titled “What you have now”- A bounded Core intake request that carries the shaped intent’s outcome and boundaries into repository work.
- The canonical artifact path,
workspace.tomlregistration, and next processor are reported by Core; follow that processor’s approval gate before implementation.