@ngockhoale/ukit 2.8.0 → 3.0.1

package/manifests/instructionRules.yaml

@@ -4,8 +4,8 @@ description: >-
   Canonical rule-ID catalog for the root instruction contracts. Marker comments
   <!-- RULE: ID --> tag normative behavior; semantic tests prove delivery.
 # marker_in values are drawn from the fixed set of the four marker-bearing
-# contract files {templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md}.
-# templates/.omp/RULES.md and .omp/RULES.md are marker-free by SPEC §7.1 policy
+# contract files {template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md}.
+# template_project/.omp/RULES.md and .omp/RULES.md are marker-free by SPEC §7.1 policy
 # and must never appear here.
 # DEVIATION from SPEC §7.2 table: OWN-01 is marker_in: AGENTS set only (not
 # SHARED) — its anchor `PROJECT_IMPORTANT.md` does not exist in the CLAUDE
@@ -24,7 +24,7 @@ rules:
       Human-facing UKit workflow collapses to one remembered command:
       `ukit install`; after install, work in natural language inside the
       supported harnesses.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'ukit install'
   - id: CORE-02
     title: Quality first, then speed, then token discipline
@@ -32,14 +32,14 @@ rules:
     statement: >-
       Ordering of priorities for all work: quality first, then speed, then
       token discipline.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: CLS-01
     title: Trivial lane acts directly
     kind: critical
     statement: >-
       Trivial tasks (typo, label, small rename, spacing, toggle flag, obvious
       config change) act directly — no doc reads, planning, index, or agents.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'Act directly'
   - id: CLS-02
     title: Simple lane pulls smallest useful context
@@ -47,7 +47,7 @@ rules:
     statement: >-
       Simple tasks (1-2 files, clear scope, existing pattern) are handled
       directly, pulling only the smallest useful context.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'smallest useful context'
   - id: CLS-03
     title: Non-trivial lane verifies harder
@@ -55,14 +55,14 @@ rules:
     statement: >-
       Non-trivial/risky tasks read deeper, verify harder, and use the
       index-first loop then skill activation then targeted verification.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: EXEC-01
     title: Continue until write evidence or blocker
     kind: critical
     statement: >-
       For explicit implement/apply/fix requests, continue until the actual edit
       is made or a real blocker is found; never stop after read-only steps.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'actual edit is made'
   - id: EXEC-02
     title: No done-claims without Edit/Write evidence
@@ -70,7 +70,7 @@ rules:
     statement: >-
       Completion wording requires concrete Edit/Write evidence in the current
       turn, plus verification when the scope is risky.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'concrete Edit/Write evidence'
   - id: EXEC-03
     title: Routed continuation is not a stopping point
@@ -78,14 +78,14 @@ rules:
     statement: >-
       Routed states like pull-indexed-context or continuation-required are
       internal continuation steps; finish the named milestone before widening.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: EXEC-04
     title: Every stop names its reason
     kind: critical
     statement: >-
       When a turn ends on a user-only action, open the reply with a
       `WAITING ON YOU:` line and schedule a one-shot wakeup when available.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'WAITING ON YOU'
   - id: STALL-01
     title: Announce waits, verbatim errors, never blame UKit
@@ -94,7 +94,7 @@ rules:
       Long waits must be announced as they happen, any API/tool error surfaced
       verbatim in the same turn, and network/API named as the suspect on long
       stalls — never blaming UKit.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'never blame UKit'
   - id: STALL-02
     title: Stall rules extend every-stop-says-why
@@ -102,7 +102,7 @@ rules:
     statement: >-
       The stall/wait reporting rules extend the existing every-stop-names-its-
       reason contract (EXEC-04); they do not replace it.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: STALL-03
     title: One-tool-call workaround is conditional only
     kind: critical
@@ -111,7 +111,7 @@ rules:
       workaround that fires only when malformed/concatenated tool-input errors
       are observed or the harness version is known-affected — healthy hosts
       keep using legitimate parallel calls.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'one tool call per assistant message'
   - id: UNATTENDED-01
     title: Unattended mode runs the completion loop without a human
@@ -121,7 +121,7 @@ rules:
       loop — the loop is UNDERSTAND → PLAN → IMPLEMENT → VERIFY → FIX →
       REVERIFY → COMPLETE, and a turn ends only on COMPLETE evidence, a real
       external blocker, or a deny decision.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'no human in the loop'
   - id: UNATTENDED-02
     title: Bounded attempts and recovery strategies in unattended mode
@@ -130,7 +130,7 @@ rules:
       maxAttemptsPerFailure: 2 per failing verification and
       maxRecoveryStrategies: 2 distinct fix strategies before reassessing —
       do not loop one strategy.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: UNATTENDED-03
     title: BLOCKED only on true external blockers
     kind: critical
@@ -138,7 +138,7 @@ rules:
       Test failures, lint errors, review findings, and ambiguity are NOT
       blockers — they feed FIX; BLOCKED is reserved for missing credentials,
       dead services, and unreachable network/API.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'NOT blockers'
   - id: UNATTENDED-04
     title: A deny becomes the next safer alternative, never a question
@@ -147,7 +147,7 @@ rules:
       A deny (hook/gate/permission) never becomes a question — pick the next
       safer alternative that satisfies the intent and record the substitution;
       never emit "do you want me to…".
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'next safer alternative'
   - id: LONG-01
     title: LAND one thing, DEFER the rest, DELEGATE broad work
@@ -155,21 +155,21 @@ rules:
     statement: >-
       Near token-cap, land one in-flight item end-to-end, defer the rest into
       docs/STATUS.md or bounded handoff tasks, delegate broad work to subagents.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: LONG-02
     title: Post-compact continuity from disk state
     kind: supporting
     statement: >-
       After any compact or handoff, continue from persisted disk state without
       rereading pre-compact context; delegate and keep replies short.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: IDX-01
     title: Check index freshness before code context
     kind: critical
     statement: >-
       For tasks needing code context, check the index is fresh and refresh it
       when stale or missing.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'index is fresh'
   - id: IDX-02
     title: Open top 1-3 suspect files first
@@ -177,7 +177,7 @@ rules:
     statement: >-
       Open only the top 1-3 suspect files first, then widen if needed; use the
       outline block to jump straight to the relevant region.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'top 1-3 suspect files'
   - id: IDX-03
     title: Outlines locate code; code to be changed must still be read
@@ -185,7 +185,7 @@ rules:
     statement: >-
       The outline locates code but does not describe behaviour; any code about
       to be changed must still be read.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'must still be read'
   - id: SKILL-01
     title: Auto-activate the matching skill
@@ -194,28 +194,28 @@ rules:
       On every non-trivial task, inspect installed project-local skills and
       auto-activate the matching skill immediately; end users should not need
       to know skill names.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'auto-activate the matching skill'
   - id: SKILL-02
     title: Smallest effective skill set
     kind: supporting
     statement: >-
       Use the smallest effective set of skills, usually 1-2.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: SKILL-03
     title: Upgrade skill choice on sharper evidence
     kind: supporting
     statement: >-
       If evidence becomes more specific than the original prompt, upgrade the
       active skill choice immediately.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: HELP-01
     title: Prefer internal helper commands for routing/context/verify
     kind: supporting
     statement: >-
       Prefer the index helper scripts (route-task, resolve-context,
       verify-context) for routing, related-file context, and verification.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: HELP-02
     title: Never ask contributors to run internal helpers
     kind: critical
@@ -223,7 +223,7 @@ rules:
       Do not ask normal contributors to run internal helper commands or
       memorize maintainer commands; run them yourself or tell them to rerun
       `ukit install`.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'Do not ask normal contributors'
   - id: OWN-01
     title: PROJECT_IMPORTANT.md is the canonical owner-instruction source
@@ -231,7 +231,7 @@ rules:
     statement: >-
       Read and follow the root PROJECT_IMPORTANT.md before project work; it is
       the canonical project-owner instruction source.
-    marker_in: [templates/AGENTS.md, AGENTS.md]
+    marker_in: [template_project/AGENTS.md, AGENTS.md]
     anchor: 'PROJECT_IMPORTANT.md'
   - id: SAFE-01
     title: Preserve byte-level file details on edit
@@ -239,7 +239,7 @@ rules:
     statement: >-
       Preserve UTF-8 BOM/no-BOM and LF/CRLF for existing multilingual or
       user-authored files.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'BOM/no-BOM'
   - id: SAFE-02
     title: Prefer unique current-file anchors for risky edits
@@ -247,7 +247,7 @@ rules:
     statement: >-
       For risky/shared/large edits, prefer unique current-file anchors over
       line numbers or stale pasted blocks.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'unique current-file anchors'
   - id: SAFE-03
     title: Ask on missing or ambiguous stale specs
@@ -255,49 +255,49 @@ rules:
     statement: >-
       Do not silently merge stale specs: if old_string is missing or ambiguous,
       re-read current source and ask whether to apply, adapt, or skip.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: CTX-01
     title: Deterministic segment bytes
     kind: critical
     statement: >-
       Keep prompt-segment bytes deterministic so provider prompt prefixes can
       be reused.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-01'
   - id: CTX-02
     title: Keep roles and order
     kind: critical
     statement: >-
       Keep message roles and order stable across calls.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-02'
   - id: CTX-03
     title: Keep tool IDs and continuation state
     kind: critical
     statement: >-
       Keep tool IDs and continuation state stable for prefix reuse.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-03'
   - id: CTX-04
     title: No clock/random IDs in static blocks
     kind: critical
     statement: >-
       Static prompt blocks must not contain clock values or random IDs.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-04'
   - id: CTX-05
     title: Compaction starts a new epoch
     kind: critical
     statement: >-
       Compaction starts a new cache epoch; do not expect prefix reuse across it.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-05'
   - id: CTX-06
     title: Never change data to match a cache
     kind: critical
     statement: >-
       Never mutate data to make it match a cache entry.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-06'
   - id: CTX-07
     title: No unconfirmed cache fields
@@ -305,28 +305,28 @@ rules:
     statement: >-
       Do not rely on cache fields that have not been confirmed for the route in
       use.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-07'
   - id: CTX-08
     title: Tool-result reuse needs valid freshness
     kind: critical
     statement: >-
       Reuse of tool results requires valid freshness.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-08'
   - id: CTX-09
     title: Missing usage is unknown, not zero
     kind: critical
     statement: >-
       Missing cache-usage reporting means unknown, not zero savings.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-09'
   - id: CTX-10
     title: Never cut a required check to reduce calls
     kind: critical
     statement: >-
       Never skip a required verification or check just to reduce call count.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'CTX-10'
   - id: HAND-01
     title: Handoff Quality Gate is opt-in via docs/AI_HANDOFF
@@ -334,7 +334,7 @@ rules:
     statement: >-
       The handoff quality gate activates only when a task goes through
       docs/AI_HANDOFF; daily prompts keep the old flow.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     paths: [docs/AI_HANDOFF/**]
   - id: HAND-02
     title: RUN.md is the authoritative handoff run cursor
@@ -343,7 +343,7 @@ rules:
       docs/AI_HANDOFF/RUN.md is the authoritative run cursor; only the
       HANDOFF FULLSTACK COMPLETE/BLOCKED markers after Phase done/blocked end
       a run.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'RUN.md'
     paths: [docs/AI_HANDOFF/**]
   - id: BUDGET-01
@@ -352,7 +352,7 @@ rules:
     statement: >-
       Context + verification budget rows: Trivial reads no docs, Simple reads
       MEMORY only, Non-trivial adds PROJECT and CODE_MAP.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: '**Trivial**: no docs'
   - id: BUDGET-02
     title: STATUS.md only for open-ended or continuation prompts
@@ -360,42 +360,42 @@ rules:
     statement: >-
       docs/STATUS.md is used for open-ended status/continue prompts or
       meaningful continuation context; stale status is orientation only.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: BUDGET-03
     title: WORKLOG recent entries only
     kind: supporting
     statement: >-
       docs/WORKLOG.md is read for recent relevant entries only; archive oldest
       entries when over limits.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: STATUS-01
     title: STATUS.md is not source truth
     kind: supporting
     statement: >-
       docs/STATUS.md captures compact current state; it is not source truth and
       must not replace source/index-first investigation.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: SUBAG-01
     title: Delegate only on meaningful context or parallel gains
     kind: supporting
     statement: >-
       Keep direct execution as default for trivial/simple work; delegate only
       when it shrinks context or enables useful parallel progress.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: SUBAG-02
     title: Small-task maintainer is a sidecar lane
     kind: supporting
     statement: >-
       The ukit-small-task-maintainer subagent handles safe/reversible UKit
       chores as a sidecar lane and hands risky work back to the main model.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: AUTO-01
     title: autonomy.level controls how much UKit acts without asking
     kind: supporting
     statement: >-
       autonomy.level in .ukit/storage/config.json controls how much UKit acts
       without asking first; end users should not need to change it.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: TIER-01
     title: Tiers bind through agent definitions
     kind: critical
@@ -403,7 +403,7 @@ rules:
       A model tier takes effect only when work is handed to an agent whose own
       definition binds that model; the main session model never changes
       mid-turn.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'model:'
   - id: TIER-02
     title: Escalate one tier after repeated failure
@@ -411,19 +411,19 @@ rules:
     statement: >-
       When the same file or symbol fails debugLoopThreshold times in one
       session, route the next attempt one tier higher, capped at smart.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: DURA-01
     title: DuraOne skill activates only when installed
     kind: supporting
     statement: >-
       The DuraOne skill is active only when the duraone pack is installed or
       .claude/skills/duraone/SKILL.md exists; otherwise use generic standards.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
   - id: FALLBACK-01
     title: Missing/corrupt runtime → rerun ukit install
     kind: critical
     statement: >-
       If the workspace needs a refresh or runtime files are missing or corrupt,
       tell maintainers to rerun `ukit install`.
-    marker_in: [templates/CLAUDE.md, templates/AGENTS.md, CLAUDE.md, AGENTS.md]
+    marker_in: [template_project/CLAUDE.md, template_project/AGENTS.md, CLAUDE.md, AGENTS.md]
     anchor: 'rerun `ukit install`'

package/manifests/platform.full.yaml

@@ -248,7 +248,7 @@ items:
 
   # Shipped internal-orchestration detail (tier tables, subagent policy, sidecar review,
   # small-task maintainer, helper/runtime/budget/status detail, DuraOne). Extracted from
-  # templates/instructions/core.md in DOC-104; `overwrite_with_backup` so `ukit update`
+  # template_project/instructions/core.md in DOC-104; `overwrite_with_backup` so `ukit update`
   # refreshes it alongside the root contracts that point at it.
   - id: docs-ukit-internals
     type: config
@@ -1799,11 +1799,11 @@ items:
     packs:
       - core
 
-  # BUG-C21-14: this file shipped in templates/ but was never manifest-listed, so
+  # BUG-C21-14: this file shipped in template_project/ but was never manifest-listed, so
   # autoDiscoverTemplates:false silently skipped it and the agent-documented
   # `node .claude/ukit/index/task-budget-validator.mjs` command 404'd on installs.
   # tests/manifest/settingsHookCoverage.test.js now asserts every file under
-  # templates/.claude/ukit/index/ is covered, which immunizes the next added module.
+  # template_project/.claude/ukit/index/ is covered, which immunizes the next added module.
   - id: ukit-index-task-budget-validator-script
     type: config
     sourceTemplate: .claude/ukit/index/task-budget-validator.mjs
@@ -1837,7 +1837,7 @@ items:
   # under `.omp/` would buy nothing. `.omp/agents/` must be real files because omp skips
   # `.claude/agents/*.md` outright (TASK_AGENT_CONFIG_SOURCE = ".omp").
   # `autoDiscoverTemplates: false` means a template file without an item here is silently
-  # never installed — every file under `templates/.omp/` needs exactly one entry below.
+  # never installed — every file under `template_project/.omp/` needs exactly one entry below.
 
   - id: multi-omp-agents-md
     type: config

package/manifests/platform.user.yaml

@@ -10,7 +10,7 @@ description: >
 items:
   - id: user-readme
     type: config
-    sourceTemplate: user/README.md
+    sourceTemplate: README.md
     targetPath: README.md
     requires: []
     mergeStrategy: skip
@@ -21,7 +21,7 @@ items:
 
   - id: user-config
     type: config
-    sourceTemplate: user/storage/config.json
+    sourceTemplate: storage/config.json
     targetPath: storage/config.json
     requires: []
     mergeStrategy: skip
@@ -32,7 +32,7 @@ items:
 
   - id: user-playbook-bugfix
     type: config
-    sourceTemplate: user/playbooks/bug-fix.md
+    sourceTemplate: playbooks/bug-fix.md
     targetPath: playbooks/bug-fix.md
     requires: []
     mergeStrategy: skip
@@ -43,7 +43,7 @@ items:
 
   - id: user-playbook-issue
     type: config
-    sourceTemplate: user/playbooks/issue-implementation.md
+    sourceTemplate: playbooks/issue-implementation.md
     targetPath: playbooks/issue-implementation.md
     requires: []
     mergeStrategy: skip

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "2.8.0",
+  "version": "3.0.1",
   "description": "Install/update an index-first AI workspace for Claude Code, OpenAI Codex and omp (Oh My Pi).",
   "license": "MIT",
   "type": "module",
@@ -30,14 +30,15 @@
     "bin/",
     "src/",
     "scripts/",
-    "templates/",
-    "!templates/**/.smbdelete*",
-    "!templates/.smbdelete*",
+    "template_project/",
+    "template_user/",
+    "!template_project/**/.smbdelete*",
+    "!template_project/.smbdelete*",
     "CHANGELOG.md",
     "LICENSE",
-    "templates/CLAUDE.md",
-    "templates/AGENTS.md",
-    "templates/.gitignore",
+    "template_project/CLAUDE.md",
+    "template_project/AGENTS.md",
+    "template_project/.gitignore",
     "manifests/"
   ],
   "publishConfig": {