| name | spectre-feature-root |
| description | Internal initializer for a missing Spectre feature root. Invoke only from a standalone workflow with no confirmed managed root. Do NOT invoke for existing roots, orchestrated calls missing a root, or direct user requests. |
| user-invocable | false |
feature-root
Purpose
Create a canonical root with no naming/reuse gate.
Inputs
Work/name hint; KIND=feature|bug (default feature); repo-relative candidate; write authority.
Working Set
Read exact candidates/ignore state only; never select existing work.
Outputs + DONE
Return FEATURE, repo-relative FEATURE_ROOT, warnings. DONE: valid root, neutral marker, tenancy, no phase artifact.
Method / guardrails
- Use an explicit caller candidate/descendant. Reject absolute, traversal, symlink-escaping, or unmanaged paths.
- Otherwise derive a concise kebab name and choose the first free
.spectre/{features|bugs}/<name>[-N]/ per KIND. Never inspect or offer existing roots, ask whether to reuse one, present naming options, or wait for approval; suffixes resolve collisions.
- Create
feature.json containing only schema_version, created_at, feature, and repo-relative feature_root; no lifecycle, alias, branch, or absolute path.
- Unless
.spectre/ is ignored, preserve .spectre/.gitignore; require literal manifest.json, bin/, handoffs/, !features/, !bugs/, plus evidence/, checkpoints/, runs/, markers/, working_set.json, cleanup_summary.md, execution_state.md, reviews/task_review_attempt.json, reviews/task_review_safety.json under both features/**/ and bugs/**/. Specs/research/decisions/reviews/proof stay trackable. Never edit root .gitignore; warn on local-only matches.
- Write only root initialization.
Handoff
Return values/warnings; caller owns routing.
Escalate-If
Unsafe candidate/escape, marker/root conflict, or insufficient write authority. Naming ambiguity or collision never escalates.
