bootstrap

Bootstrap

The top-level skill owns every user-facing question. The retained scaffolder is a bounded, non-interactive worker invoked only after the answer it needs is durable in the target knowledge base.

{% include_shared "parent-owned-interview.md" %}

Invariants

• Keep metadata.is_workflow: false; bootstrap may start outside an initialized project.
• Known _TBD_ sections in charter.md and preferences.md are the only resume state.
• Workflow events are telemetry only. Never use them to decide which question or action comes next.
• Do not create scratch pads, bootstrap markers, checkpoint comments, context sidecars, relay envelopes, continuation payloads, or generalized scaffold probes.
• Use the same parent-owned topology on every platform. Do not use platform-specific interaction tags.
• MUST NOT dispatch inside either interview loop. Across one invocation, dispatch at most one PLAN action, one optional REVISE action, and one APPLY action.

Procedure

1. Validate Every Project Name Before Effects

Begin from a non-mutating directory inventory. Inspect only the current directory and safe-named direct children when looking for resumable work; do not recurse through arbitrary directories.

Validate every supplied, inferred, or recovered project name against ^[a-z0-9][a-z0-9-]*$ before using it as a path segment. Do not trim, sanitize, lowercase, or otherwise rewrite a candidate. Reject separators, .., whitespace, globs, punctuation other than -, an empty name, or a leading hyphen with actionable lowercase-kebab-case guidance.

Target discovery:

1. Enumerate the current directory name and direct-child names without entering them.
2. Discard a name unless it passes the project-name regex, then retain only candidates with their own .rp1/project_id. Never derive a candidate path from an unsafe name, and never treat an ancestor project as candidate initialization.
3. If one initialized candidate exists, offer to inspect and use it. If several exist, present only the validated names and ask the user to choose one or provide a new name. If none exists and no argument was supplied, infer the current directory basename only when the current directory is already its own rp1 project; otherwise ask for a name.
4. Do not call a selected initialized target resumable until Section 2 resolves its canonical directories and {targetKbRoot}/preferences.md exists. A resumable candidate exists only when its resolved {targetKbRoot}/preferences.md exists. Do not inspect run state, marker files, package manifests, or expected scaffold outputs to infer resume state.