Commit dots-dev skill into repo for cross-machine portability
Move the dots-dev skill from machine-local ~/.claude/skills/ into the repo at .claude/skills/dots-dev/ so it travels with a clone. Update the CLAUDE.md per-machine setup note to reflect that the skill no longer needs manual placement; unity-mcp-skill and native memory/ stay local. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Luis Gonzalez
@@ -0,0 +1,98 @@
|
||||
# Per-phase swarm brief templates
|
||||
|
||||
Fill the `{…}` variables and paste into the agent prompt. Keep each agent's context lean — pass only the immediately upstream summary, not the whole session. Every research/scan brief is **read-only** (plan mode through Phase 5). All briefs assume the agent will return raw data/findings, not a human-facing message.
|
||||
|
||||
Conventions referenced below live in [`dots-conventions.md`](dots-conventions.md); the context7 playbook in [`context7-libraries.md`](context7-libraries.md).
|
||||
|
||||
---
|
||||
|
||||
## Phase 1 — Context (Explore, read-only)
|
||||
|
||||
**A — Code/asset graph**
|
||||
> READ-ONLY. Map the code surface relevant to `{goal}`. Prefer serena `find_symbol`/`find_referencing_symbols` over text search; if serena's C# LSP errors or times out on the Unity solution, fall back to `Glob`/`Grep` on `Assets/_Project/**/*.cs` and `**/*.asmdef`. Identify: existing components/systems/bakers touching `{surface}`, the asmdef each lives in (shared-simulation / client / server / authoring), and any TODOs. Also `manage_scene(action="get_hierarchy")` for relevant subscenes. Return a terse symbol/asmdef map (names + paths), not file dumps.
|
||||
|
||||
**B — Knowledge state**
|
||||
> READ-ONLY. Search the in-repo vault (obsidian-cli) and `basic-memory` for design docs, decision records, and notes touching `{goal}`. Return: relevant doc paths, any locked decisions that constrain `{goal}`, open questions already recorded. Quote ≤2 load-bearing lines each; link by path otherwise.
|
||||
|
||||
**C — Unity live state**
|
||||
> READ-ONLY. Read `mcpforunity://editor/state`, `project/info`, `instances`. `read_console(types=["error","warning"], count=20)`. `manage_packages(action="list")` — report the **installed** Entities + Netcode versions (needed to pin context7). Flag any pre-existing compile/Burst errors as a baseline.
|
||||
|
||||
---
|
||||
|
||||
## Phase 2 — Goal spec (general-purpose)
|
||||
|
||||
> Inputs: operator's verbatim goal + the Phase 1 Project Brief, nothing else. Produce a Goal Spec: **Deliverables** (each: name, surface, "done when"), **Assumptions** (to validate at review), **Open ambiguities** (frame each as a yes/no or multiple-choice question). Flag any conflict with a locked decision from the brief.
|
||||
|
||||
---
|
||||
|
||||
## Phase 3 — Research (context7-first)
|
||||
|
||||
**A — DOTS/Netcode implementation (context7 primary)**
|
||||
> Inputs: Goal Spec only. For each API/pattern `{goal}` needs, use context7: `resolve-library-id` (seeds in context7-libraries.md; pin to the installed version `{entities_ver}`/`{netcode_ver}`) → `query-docs` with specific questions. Cross-check the official ECS Samples repo. Return: for each deliverable, the current correct API shape + a minimal code pattern + the exact context7 query used. Flag any API the plan assumes that context7 shows removed/renamed.
|
||||
|
||||
**B — Determinism / netcode correctness (context7 + samples)**
|
||||
> Inputs: Goal Spec only. Confirm via context7: prediction-group placement, `Simulate` filtering, ghost replication setup, input (`IInputComponentData`) flow, world/bootstrap shape for `{goal}`. Return current API shapes + determinism pitfalls specific to `{goal}`.
|
||||
|
||||
**C — Genre/design precedent (web, optional)**
|
||||
> Inputs: Goal Spec only. `WebSearch`/`WebFetch` ONLY. How do comparable games solve the *design* of `{mechanic}`? Return: what to steal / what to avoid. Do NOT return DOTS API claims from the web.
|
||||
|
||||
Orchestrator synthesizes a ≤500-word Research Digest (steal / avoid / still-unclear + the context7 queries used).
|
||||
|
||||
---
|
||||
|
||||
## Phase 4 — Design & plan (Plan, read-only)
|
||||
|
||||
**A — Code architect**
|
||||
> Inputs: Brief + Goal Spec + Research Digest. Design the C#/ECS layer for `{goal}` respecting dots-conventions.md: components (`IComponentData`/buffer/enableable), systems (`ISystem`+Burst vs `SystemBase`), jobs, system groups/order, ECB usage, and which asmdef each file lands in. Output: file list (repo-relative) + class/system signatures only (no bodies) + build order with compile checkpoints.
|
||||
|
||||
**B — Scene/subscene/baking architect**
|
||||
> Inputs: same. Design authoring + baking: `…Authoring` MonoBehaviours + `Baker<T>`, subscene layout, ghost prefabs/authoring, config assets, URP/Entities-Graphics needs. Output: assets/subscenes to create (repo-relative) + what bakes into what.
|
||||
|
||||
**C — Vault doc architect**
|
||||
> Inputs: same. Design vault changes: which design docs get edited in place, whether a decision record is warranted, the session-log scaffold. Output: doc paths + one-line intent each (wikilink, don't duplicate).
|
||||
|
||||
Orchestrator writes the Unified Implementation Plan (see SKILL Phase 4).
|
||||
|
||||
---
|
||||
|
||||
## Phase 6 — Implementation (general-purpose)
|
||||
|
||||
**A — Script author**
|
||||
> Inputs: the approved plan slice for `{files}`. Create via `create_script`, edit existing via `get_sha`→`apply_text_edits`. `validate_script` non-trivial files first. `read_console(types=["error"])` after EVERY write; fix before moving on. Re-query context7 for any signature the digest left ambiguous. Honor dots-conventions.md (Burst-compatible, unmanaged components, deterministic sim, ECB for structural changes).
|
||||
|
||||
**B — Scene/subscene/baking wirer**
|
||||
> Inputs: the approved plan slice. Create authoring components, subscenes, ghost prefabs, config assets; save scenes. Confirm Edit Mode (`manage_editor(action="play_state")`) before structural changes. `batch_execute` for bulk. Wait for a referenced component to compile before attaching/baking it.
|
||||
|
||||
**C — Asmdef/package guardian** (conditional)
|
||||
> Inputs: the approved plan slice. Add/adjust `.asmdef`s keeping the client/server/shared/authoring split clean. Never touch `.csproj`/`.sln`. Verify it compiles via `read_console`.
|
||||
|
||||
**D — Doc-skeleton author** (conditional)
|
||||
> Inputs: the approved plan slice. Create new vault docs with full frontmatter skeletons via obsidian-cli (bodies are written in Phase 8).
|
||||
|
||||
---
|
||||
|
||||
## Phase 7 — Validate (general-purpose, DOTS-aware)
|
||||
|
||||
**A — Console/Burst/source-gen sweep**
|
||||
> `read_console(types=["error","warning","exception"], count=50, include_stacktrace=True)`. Compare to the Phase-1 baseline. Any NEW error/warning — including Burst/source-gen — is a finding. Return blocking vs nit.
|
||||
|
||||
**B — Test runner**
|
||||
> If the plan specified tests: `run_tests(mode="EditMode")`→`get_test_job(... include_failed_tests=True)`; PlayMode if applicable. For netcode: a `NetCodeTestWorld` connect/tick test or a thin-client check. Return pass/fail with failing-test detail.
|
||||
|
||||
**C — Runtime/determinism spot-check**
|
||||
> If visual/runtime: brief Play Mode entry (`set_play_state`), step ticks, confirm predicted/interpolated ghosts behave; screenshot Game/Scene view (`manage_camera`); exit to Edit Mode. Verify each plan-specified entity/component exists (`get_hierarchy` + `manage_components(action="get")`). Return findings.
|
||||
|
||||
Fix loop: ≤3 iterations per finding via a tight 1–2 agent fix sub-swarm, re-running only the affected validator.
|
||||
|
||||
---
|
||||
|
||||
## Phase 8 — Doc + memory (general-purpose)
|
||||
|
||||
**A — Session log**
|
||||
> Write `<repo>/Docs/Vault/07_Sessions/{year}/{date}_{Topic}.md` via obsidian-cli using the vault's session-log template. Sections: Goal, What happened, Decisions (link records), Files touched (Unity + vault, repo-relative), Open questions, Next-session intent, Notes. Same-day collision → suffix `_A`/`_B`.
|
||||
|
||||
**B — Decision records + design docs**
|
||||
> For each firm decision, write a decision record in `_Decisions/`, back-referenced from the session log. Edit touched design docs in place (wikilink, don't duplicate). Update roadmap/backlog for deferred items.
|
||||
|
||||
**C — Memory updater**
|
||||
> Durable cross-machine knowledge → a `basic-memory` note in the vault. Machine-local facts/feedback/working-style → native `MEMORY.md` (+ a memory file if substantive). Do NOT put cross-machine truth only in native memory — it doesn't sync between the Mac and Windows machines.
|
||||
@@ -0,0 +1,44 @@
|
||||
# context7 — DOTS library IDs & query playbook
|
||||
|
||||
**context7 is the primary source of truth for every DOTS API, signature, and "current best practice."** Unity's Entities/Netcode packages change between minor versions; training-data recall is stale. Resolve → query before writing DOTS code.
|
||||
|
||||
## Flow
|
||||
|
||||
1. `resolve-library-id(libraryName, query)` → pick the Context7 ID (prefer High reputation + high snippet count + version matching the **installed** package).
|
||||
2. `query-docs(libraryId, query)` with a *specific* question ("How do I declare an IInputComponentData and read it in a predicted system in Netcode 1.x?"), not a bare keyword.
|
||||
3. Cross-check working patterns against the official **ECS Samples** repo ID below.
|
||||
4. Limit: ≤3 `resolve` calls and ≤3 `query` calls per question (the tool enforces this). Reuse IDs across a session.
|
||||
|
||||
## Pin to the installed version
|
||||
|
||||
Before querying, read the installed version from `Packages/packages-lock.json` (or `manage_packages action=list`). If it differs from a seed ID's version, **re-resolve** and prefer the doc set matching what's installed. The seeds below were captured during skill authoring and may lag the project.
|
||||
|
||||
## Seed library IDs (re-resolve if installed version differs)
|
||||
|
||||
| Package | Primary Context7 ID | Alt | Notes |
|
||||
|---|---|---|---|
|
||||
| **Entities (DOTS)** | `/websites/unity3d_packages_com_unity_entities_1_4` | `/needle-mirror/com.unity.entities` | ~7,099 snippets, High. Core ECS. |
|
||||
| **Netcode for Entities** | `/websites/unity3d_packages_com_unity_netcode_1_10_api` | `/websites/unity3d_packages_com_unity_netcode_1_9` | ~2,512 snippets, High. Ghosts/prediction/RPC/input. |
|
||||
| **Entities Graphics** | `/websites/unity3d_packages_com_unity_entities_graphics_1_4` | — | Rendering entities under URP/HDRP. |
|
||||
| **Official ECS Samples** | `/unity-technologies/entitycomponentsystemsamples` | — | Working sample patterns; Entities, Netcode, Physics, Graphics. |
|
||||
| **Unity Physics** | resolve at runtime | — | `resolve-library-id(libraryName="Unity Physics", query="DOTS collision/triggers")`. |
|
||||
| **Burst** | resolve at runtime | — | `libraryName="Unity Burst"`. |
|
||||
| **Collections** | resolve at runtime | — | `libraryName="Unity Collections"` (Native/Unsafe containers, allocators). |
|
||||
| **Mathematics** | resolve at runtime | — | `libraryName="Unity Mathematics"` (float3/quaternion/math). |
|
||||
|
||||
> Confirm Netcode for Entities is `com.unity.netcode` (the ECS netcode), **not** `com.unity.netcode.gameobjects` (Netcode for GameObjects). They are different products.
|
||||
|
||||
## Query patterns that work (examples)
|
||||
|
||||
- "Entities 1.x: declare an `IJobEntity` that writes through an `EntityCommandBuffer.ParallelWriter` and schedule it with the right dependency."
|
||||
- "Netcode for Entities: minimal `GhostAuthoringComponent` + `[GhostField]` setup for a predicted player-controlled ghost."
|
||||
- "Netcode for Entities: read `IInputComponentData` inside a system in `PredictedSimulationSystemGroup`, filtered by `Simulate`."
|
||||
- "Entities: correct `Baker<T>` use of `GetEntity` with `TransformUsageFlags` and `DependsOn`."
|
||||
- "Netcode for Entities: subclass `ClientServerBootstrap` to create client/server worlds and target systems with `WorldSystemFilter`."
|
||||
- "Entities: `IEnableableComponent` vs add/remove tag — API and when each is cheaper."
|
||||
|
||||
## When NOT to use context7
|
||||
|
||||
- Genre/design precedent ("how do other games pace waves") → `WebSearch`/`WebFetch`.
|
||||
- Pure C#/algorithm questions unrelated to a library → reason directly.
|
||||
- The project's own conventions/design → `CLAUDE.md` + the vault.
|
||||
@@ -0,0 +1,68 @@
|
||||
# DOTS / Netcode for Entities — Conventions & Gotchas
|
||||
|
||||
Reusable rule set the `/dots-dev` skill enforces. Targets **Unity 6.x, Entities 1.3+/1.4+, Netcode for Entities 1.x**. These APIs move fast — anything flagged **[verify]** must be confirmed via context7 at code-time (see [`context7-libraries.md`](context7-libraries.md)), not trusted from memory. The project's `CLAUDE.md` is authoritative where it differs.
|
||||
|
||||
These conventions **replace** classic MonoBehaviour/GameObject conventions. If a design reaches for a MonoBehaviour singleton, a ScriptableObject "service" for runtime simulation, `[SerializeField] private` data carriers, or coroutines for sim logic, it is almost certainly wrong for DOTS.
|
||||
|
||||
## 1. Code structure
|
||||
|
||||
- **`struct : IComponentData`** — the default. Unmanaged, blittable, Burst- and job-friendly. Use for nearly all data.
|
||||
- **`class : IComponentData`** — managed component. Only for genuine managed refs (a `GameObject`, `Material`). Main-thread only, no Burst, no jobs. Keep out of hot paths.
|
||||
- **`IBufferElementData`** — per-entity dynamic array (`DynamicBuffer<T>`): inventory, path points, command history.
|
||||
- **`ISharedComponentData`** — groups entities into chunks by shared value; changing it is a **structural change**. Use sparingly; prefer unmanaged shared components.
|
||||
- **`IEnableableComponent`** — toggle a component on/off **without a structural change**. Prefer over add/remove tag components for frequently-flipped state. Enabled by default.
|
||||
- **Systems**: `ISystem` (struct, Burst-compatible — **default**) vs `SystemBase` (class, managed, main-thread, no Burst — only when you must touch managed objects). Tag system methods `[BurstCompile]`.
|
||||
- **`SystemAPI`** is the entry point inside systems: `SystemAPI.Query<...>()`, `.GetComponent`, `.Time`, `.GetSingleton`. Source-generated; valid only inside `ISystem`/`SystemBase`.
|
||||
- **Aspects (`IAspect`) are DEPRECATED as of Entities 1.4 — do not author new ones.** Use components + `SystemAPI.Query`/`IJobEntity` directly. `Entities.ForEach` is legacy; avoid. **[verify]** the current recommended replacement.
|
||||
- **Naming**: components are nouns/adjectives (`Health`, `Velocity`, `MoveSpeed`); tags suffix-free or `…Tag`; authoring MonoBehaviours suffix `Authoring`; systems suffix `System`; buffer elements often `…Element`/`…BufferElement`.
|
||||
|
||||
## 2. Jobs & Burst
|
||||
|
||||
- **`IJobEntity`** — preferred per-entity job (source-generated `Execute` over a query). **`IJobChunk`** — lower-level, chunk-wide/manual iteration. **`SystemAPI.Query`** — main-thread iteration.
|
||||
- **Scheduling** — `Schedule()` / `ScheduleParallel()`; thread the returned `JobHandle` through `state.Dependency`. Avoid manual `.Complete()` unless you need results now (it's a sync point).
|
||||
- **Burst breaks on** — managed types, `try/catch`/exceptions, `typeof`/reflection, virtual calls, `string` ops, GC allocation, most of `System.*`. Keep job code `unmanaged`.
|
||||
- **Collections** — `NativeArray/List/HashMap`, `NativeQueue`, etc. Allocators: `Allocator.Temp` (frame/scope, auto-freed, **not** across job boundaries), `Allocator.TempJob` (one job, must dispose), `Allocator.Persistent` (long-lived, must dispose). **Always dispose** non-Temp, or `.Dispose(jobHandle)`.
|
||||
- Mark inputs `[ReadOnly]` to allow parallel access; write-aliasing across parallel jobs is a safety error.
|
||||
|
||||
## 3. Baking (authoring → entities)
|
||||
|
||||
- **Why**: authoring data is converted **offline at edit/import time** into entities — no runtime conversion cost, deterministic, streamable.
|
||||
- **Pattern**: a `MonoBehaviour` named `…Authoring` + `class FooBaker : Baker<FooAuthoring>` whose `Bake()` calls `GetEntity(...)` then `AddComponent(entity, new Foo{...})`.
|
||||
- **Subscenes** hold baked entities and stream in/out asynchronously — entities are **not present the instant a subscene reference exists**; gate logic on load state.
|
||||
- **Mistakes**: referencing other entities without `GetEntity(authoring, TransformUsageFlags.…)`; not declaring `DependsOn` (so bake doesn't re-run on asset change); doing runtime-only work in `Bake()`; forgetting `TransformUsageFlags` (→ missing `LocalTransform`).
|
||||
|
||||
## 4. Netcode for Entities
|
||||
|
||||
- **Ghosts** = replicated entities. Mark a prefab with **`GhostAuthoringComponent`**; mark replicated fields with **`[GhostField]`**; tune per-component replication with **`[GhostComponent]`** (e.g. `SendToOwner`). Variants via **`IGhostComponentVariation`**. **[verify]** attribute parameters.
|
||||
- **Predicted vs interpolated ghosts**: predicted = simulated locally + rolled back (player-controlled, fast reaction). Interpolated = smoothed display of past server state (remote/non-critical).
|
||||
- **Prediction & rollback**: core sim runs in **`PredictedSimulationSystemGroup`**, a **fixed-step** group on **both client and server**. On each new snapshot the client re-simulates from the oldest received tick → systems run **multiple times per frame**; sim code must be idempotent/deterministic. Filter queries with **`.WithAll<Simulate>()`** so only currently-simulated entities run. **[verify]** group internals/names.
|
||||
- **Server-authoritative**: server is truth; clients send **input**, not state.
|
||||
- **Input**: prefer **`IInputComponentData`** (auto-buffered to `InputBufferData<T>`); `ICommandData` is the lower-level command-buffer form. Don't read raw `UnityEngine.Input` in sim systems. **[verify]** helper signatures.
|
||||
- **RPCs**: `struct : IRpcCommand` for one-off events (connect, requests). Not for per-tick state.
|
||||
- **Determinism**: no `Time.deltaTime`/wall-clock in sim — use the netcode fixed tick. Avoid non-deterministic float sources, `System.Random`, ordering by hash. Cross-machine float determinism is fragile — keep predicted sim simple and consistent.
|
||||
- **Worlds & bootstrap**: separate **client** and **server** `World`s; subclass **`ClientServerBootstrap`** (`CreateClientWorld`/`CreateServerWorld`) to customize. Annotate systems with `[WorldSystemFilter(...)]` to target client/server/thin. **[verify]** bootstrap method names + `WorldSystemFilterFlags`.
|
||||
|
||||
## 5. Common footguns
|
||||
|
||||
- **Structural changes** (add/remove component, create/destroy entity, set shared component) **invalidate `Entity`/component handles & references** and cause sync points. Batch via **ECB**.
|
||||
- **ECB (`EntityCommandBuffer`)**: record now, play back later. Use built-in `Begin/EndSimulationEntityCommandBufferSystem` (and `BeginInitialization…`). One ECB per job; in parallel jobs use `.AsParallelWriter()`. Don't read back values you just recorded.
|
||||
- **System order**: `[UpdateInGroup]`, `[UpdateBefore/After]`. Key groups: `InitializationSystemGroup`, `SimulationSystemGroup`, `PresentationSystemGroup`; netcode adds `PredictedSimulationSystemGroup`, `GhostSimulationSystemGroup`. **[verify]** netcode group set.
|
||||
- **Main-thread-only**: managed components, `EntityManager` structural ops, most `World`/managed access. Keep out of Burst jobs.
|
||||
- **No managed refs in unmanaged components** — won't compile / breaks Burst. Use a managed `IComponentData`, a `BlobAssetReference`, or an `Entity` reference instead.
|
||||
- **Subscene timing & GO↔entity mixing**: entities may not exist yet; bridging GameObjects↔entities is manual and a known pain point — design around it, don't sprinkle hybrid links.
|
||||
|
||||
## 6. Testing (what "compiles clean" misses)
|
||||
|
||||
- **`NetCodeTestWorld`** — spins up in-process client+server worlds for deterministic tick-by-tick netcode tests (connect, tick, assert on ghosts/RPCs).
|
||||
- **Thin clients** — stripped dummy clients for soak/load testing in-editor (no rendering/full sim); spawn via Multiplayer PlayMode Tools.
|
||||
- **Entities logic** — standard test world + `World.Update()` stepping (EntitiesTestFixture-style).
|
||||
- Burst/source-gen failures surface at **editor compile/play**, not a plain C# build. Determinism desync, rollback bugs, sync-point stalls, and structural-change invalidation only show at **runtime under prediction** — always run a play/tick test, not just a build.
|
||||
|
||||
## 7. Verify via context7 at code-time (volatile — do NOT hardcode)
|
||||
|
||||
- Aspect deprecation status & the recommended replacement.
|
||||
- Exact **system group names/order** and netcode prediction-group internals.
|
||||
- **Input** API (`IInputComponentData` vs `ICommandData`) helper signatures.
|
||||
- Ghost attribute options (`[GhostField]`/`[GhostComponent]` parameters, variants).
|
||||
- Bootstrap/world-creation method names and `WorldSystemFilterFlags`.
|
||||
- ECB system names + allocator/Collections API surface.
|
||||
@@ -0,0 +1,48 @@
|
||||
# Memory & Documentation Protocol
|
||||
|
||||
How `/dots-dev` reads and writes knowledge. Four layers, each with a distinct job. The **in-repo vault is the single source of human-facing, cross-machine truth**; everything else serves or accelerates it.
|
||||
|
||||
## The four layers
|
||||
|
||||
| Layer | Holds | Interface | Crosses machines? |
|
||||
|---|---|---|---|
|
||||
| **In-repo Obsidian vault** `<repo>/Docs/Vault/` | Design docs, decision records, session logs, roadmap — the canonical human-facing record | **obsidian-cli** skill (read/create/search); Obsidian REST MCP optional | **Yes** (committed to git) |
|
||||
| **basic-memory** MCP | Semantic + wikilink-graph recall over the *same* vault files (so the agent finds knowledge without grepping) | `basic-memory` MCP tools | Yes (indexes the committed vault) |
|
||||
| **serena** MCP | C# symbol-level code navigation (`find_symbol`, references, edit-by-symbol) of a growing codebase | `serena` MCP tools | N/A (derived from code) |
|
||||
| **Native Claude memory** | Machine-local facts, feedback, working-style; the per-project `memory/` dir + `MEMORY.md` + `CLAUDE.md` | Write tool / memory files | **No** — local to each machine |
|
||||
|
||||
**Cross-machine rule:** anything that must be true on both your Mac and Windows machines goes in the **vault** (or `CLAUDE.md`, which is also committed). Native `memory/` is convenience only — never the sole home of a decision or design fact.
|
||||
|
||||
## Which tool when
|
||||
|
||||
- **"Where is X defined / who calls it?"** → serena `find_symbol` / references. Fall back to `Glob`/`Grep` if serena's C# LSP stalls on the Unity solution.
|
||||
- **"What did we decide about Y / how does system Z work conceptually?"** → `basic-memory` recall, then obsidian-cli to read the doc.
|
||||
- **"Find the literal string/asset GUID"** → `Grep`/`Glob`.
|
||||
- **"What's the current DOTS/Netcode API for…?"** → context7 (NOT memory). See [`context7-libraries.md`](context7-libraries.md).
|
||||
- **"What conventions/preferences apply here?"** → `CLAUDE.md` + native memory.
|
||||
|
||||
## Session bookends (non-negotiable for non-trivial work)
|
||||
|
||||
**Start — scan (read-only):**
|
||||
1. `CLAUDE.md` (repo root).
|
||||
2. Vault map of content + latest session log (`07_Sessions/<year>/`).
|
||||
3. Open decision records (`_Decisions/` `status: proposed`) + roadmap/backlog.
|
||||
4. `basic-memory` recall on the goal's nouns; native `MEMORY.md` + `memory/`.
|
||||
|
||||
**End — update (Phase 8):**
|
||||
1. Session log written to the vault (obsidian-cli).
|
||||
2. Firm decisions → decision records, back-referenced from the log.
|
||||
3. Touched design docs edited in place (wikilink, don't duplicate into the log).
|
||||
4. Durable knowledge → `basic-memory` note in the vault; machine-local facts → native `MEMORY.md`.
|
||||
|
||||
If the operator says "skip the protocol", still write a one-line stub session log so the gap is visible, and record the preference as a native feedback memory.
|
||||
|
||||
## Fallbacks
|
||||
|
||||
- **No obsidian-cli configured** → direct `Read`/`Write` on `<repo>/Docs/Vault/**` (it's plain markdown; Obsidian/basic-memory pick up changes on next index).
|
||||
- **basic-memory down** → obsidian-cli search + `Grep` over the vault.
|
||||
- **serena C# unavailable** → `Glob`/`Grep`, or `claude-context` (local LanceDB) if it was added as the documented fallback.
|
||||
|
||||
## Setup pointer
|
||||
|
||||
The vault scaffold, the `basic-memory`/`serena` `.mcp.json` entries (using `${CLAUDE_PROJECT_DIR}`), and `CLAUDE.md` are created by the **one-time project setup task**, not by this skill. If this skill runs and the vault or memory MCPs are missing, it notes the gap and points to that setup task.
|
||||
Reference in New Issue
Block a user