diff --git a/skills/project-bootstrap/README.md b/skills/project-bootstrap/README.md index a4c0a71..d5e0bb9 100644 --- a/skills/project-bootstrap/README.md +++ b/skills/project-bootstrap/README.md @@ -24,16 +24,11 @@ clearly intends to turn into a workspace. ## Prerequisites -`project-bootstrap` does not lay out `.wiki/` or `.tasks/` by itself — it -delegates to two companion skills, which must be installed on the machine -running it: - -- [`setup-wiki`](../setup-wiki/) — creates the canonical `.wiki/` layout. -- [`setup-tasks`](../setup-tasks/) — creates the canonical `.tasks/` layout. - -If either is missing, `project-bootstrap` stops with a clear error rather -than falling back to ad-hoc creation. This keeps layout drift between -projects bootstrapped at different times debuggable. +Мета в сервисе (решения 14/15): вики и таски проекта живут в **mappa** +(`using-wiki` / `using-tasks` v2 — mappa-тулы), файловый `.wiki/` / `.tasks/` +не создаётся. `setup-wiki` / `setup-tasks` умерли (нечего настраивать); +для проектов вне mappa файловый layout создаётся ad-hoc по канону +Karpathy / `.tasks/` (см. using-wiki/using-tasks, legacy-раздел). ## What it creates @@ -42,8 +37,8 @@ projects bootstrapped at different times debuggable. | `.git/` | `git init` | Skipped if repo already initialized. | | `.gitignore` | `assets/.gitignore.template` | Skipped if file exists. | | `README.md` | minimal stub | Skipped if file exists. | -| `.wiki/` | delegated to `setup-wiki` | Karpathy LLM Wiki layout — `CLAUDE.md`, `index.md`, `log.md`, `overview.md`, `raw/`, `entities/`, `concepts/`, `packages/`, `sources/`. | -| `.tasks/` | delegated to `setup-tasks` | Canonical board — `STATUS.md` plus per-task `.md` files. | +| вики | mappa (`using-wiki`) | сущности `type=wiki` в сервисе; файловый layout — только вне mappa (легаси). | +| таски | mappa (`using-tasks`) | сущности `type=task` в сервисе; файловый `.tasks/` — только вне mappa (легаси). | | `AGENTS.md` | `assets/AGENTS.md.template` | **Canon** — skill triggers (`use project wiki`, `use task management system`, etc.). On non-Windows hosts, swap the `we're on Windows` line for `we're on Linux` / `we're on macOS`. On upgrade, the template is treated as a canonical set and merged idempotently — only missing trigger lines are appended after user confirm. Re-runs are no-ops. | | `CLAUDE.md` | generated pointer | `Canon is AGENTS.md. Read AGENTS.md.` — legacy pointer for tooling that looks for the old name. | | `.wiki/concepts/bootstrap-manifest.md` | generated | Records which skill versions initialized the project, so cross-project layout drift is debuggable. | @@ -55,11 +50,11 @@ projects bootstrapped at different times debuggable. found, what will be created, what will be skipped. 2. **Confirm.** One question, one confirmation. Nothing is written before the user agrees. -3. **Steps 1–5.** Create or skip each piece in order — git, README, `.wiki/`, - `.tasks/`, `AGENTS.md` + `CLAUDE.md` pointer. Steps 3 and 4 delegate to the setup-skills. +3. **Steps 1–5.** Create or skip each piece in order — git, README, вики/таски + (mappa, см. using-wiki/using-tasks), `AGENTS.md` + `CLAUDE.md` pointer. 4. **Step 5.5.** Write `bootstrap-manifest.md` recording the versions of - `project-bootstrap`, `setup-wiki`, `setup-tasks`, `project-discipline`, - `setup-interns`, and `using-interns` used. + `project-bootstrap`, `project-discipline`, `setup-interns`, and + `using-interns` used. 5. **Step 5.6.** Skill dependencies check. Walk the canonical trigger list in `AGENTS.md`, look each up in an embedded `trigger → fulfiller` map, detect what's missing on this host (`~/.claude/skills//SKILL.md` @@ -105,10 +100,8 @@ target with `CLAUDE_SKILLS_DIR=/path bash scripts/install.sh …`. ## See also -- [`setup-wiki`](../setup-wiki/) — companion, owns `.wiki/` layout. -- [`setup-tasks`](../setup-tasks/) — companion, owns `.tasks/` layout. -- [`using-wiki`](../using-wiki/) — runtime policy for working with `.wiki/`. -- [`using-tasks`](../using-tasks/) — runtime policy for working with `.tasks/`. +- [`using-wiki`](../using-wiki/) — runtime policy for the mappa wiki (v2). +- [`using-tasks`](../using-tasks/) — runtime policy for the mappa task board (v2). - [`project-discipline`](../project-discipline/) — cross-project rules activated by the `follow project discipline` trigger. - [`setup-interns`](../setup-interns/), [`using-interns`](../using-interns/) — diff --git a/skills/project-bootstrap/SKILL.md b/skills/project-bootstrap/SKILL.md index 75cb8df..a7f9c75 100644 --- a/skills/project-bootstrap/SKILL.md +++ b/skills/project-bootstrap/SKILL.md @@ -1,7 +1,7 @@ --- name: project-bootstrap author: ours -version: 2.0.1 +version: 2.1.0 description: > Initializes or upgrades a project in the current folder: git, .gitignore, README.md, .wiki/ using Karpathy's method, .tasks/ for task tracking, AGENTS.md (canon) with @@ -178,13 +178,14 @@ If it exists — leave it untouched. --- -## Step 3 — .wiki/ +## Step 3 — вики (mappa, решение 14/15) -**Delegate to the `setup-wiki` skill.** It handles greenfield creation, canon migration, and the no-op case (already canon) uniformly, with its own confirmation gate. Don't recreate the layout inline here — that's how drift happens. - -If `setup-wiki` is not installed on this machine, **stop** and tell the user: project-bootstrap requires `setup-wiki` (and `setup-tasks`) installed. Don't fall back to ad-hoc creation. - -**Reference (for context only — `setup-wiki` is the source of truth):** the canonical layout per Karpathy (gist: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) and `using-wiki`: +**Канал — mappa:** вики проекта = сущности `type=wiki` в сервисе (решения 14/15: +мета в сервисе). Ничего файлового создавать не нужно; операции — `using-wiki` +v2 (mappa wiki-тулы). Файловый `.wiki/` — только для проектов вне mappa +(легаси): layout по Karpathy (gist: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). +`setup-wiki` умер (нечего настраивать) — при необходимости создания страниц +используй `wiki.create` под лизом (см. using-wiki). ``` .wiki/ @@ -311,13 +312,14 @@ each get a `.gitkeep` so git tracks them. --- -## Step 4 — .tasks/ +## Step 4 — таски (mappa, решение 14/15) -**Delegate to the `setup-tasks` skill.** It handles greenfield creation, migration from flat STATUS.md, and the no-op case uniformly, with its own confirmation gate. Don't recreate the layout inline. - -If `setup-tasks` is not installed, **stop** and tell the user — same rule as Step 3. - -**Reference (for context only — `setup-tasks` is the source of truth):** the canonical layout is `.tasks/STATUS.md` (the board, with emoji status 🔴/🟡/⚪/🟢/🔵) plus `.tasks/.md` per active or paused task. The full pattern is documented in this repo at `.wiki/raw/setup-task-status-wiki.md`. +**Канал — mappa:** борд проекта = сущности `type=task` в сервисе (решения +14/15: мета в сервисе). Ничего файлового создавать не нужно; операции — +`using-tasks` v2 (mappa task-тулы). Файловый `.tasks/` — только для проектов +вне mappa (легаси: `STATUS.md` + per-task файлы). `setup-tasks` умер +(нечего настраивать) — таски создаются через `task_create` под лизом +(см. using-tasks/task-format). --- @@ -474,8 +476,6 @@ Skills used to initialize this project's `.wiki/` and `.tasks/` layout, with the | Skill | Version | Role | |---|---|---| | `project-bootstrap` | | orchestrator | -| `setup-wiki` | | wiki canonical layout | -| `setup-tasks` | | tasks canonical layout | | `project-discipline` | | cross-project policy | | `setup-interns` | | interns MCP server install (one-time, per machine) | | `using-interns` | | interns runtime policy + per-session permission grant | diff --git a/skills/project-discipline/SKILL.md b/skills/project-discipline/SKILL.md index 192857f..4500810 100644 --- a/skills/project-discipline/SKILL.md +++ b/skills/project-discipline/SKILL.md @@ -118,7 +118,7 @@ The skill **does not**: - modify `AGENTS.md` (that's `project-bootstrap`'s job); - enforce rules via git hooks / pre-commit / CI (this is agent discipline, not tooling); - manage `settings.json` permissions (that's `update-config`); -- check the existence of `.wiki/` / `.tasks/` (that's `setup-wiki` / `setup-tasks` / `project-bootstrap`); if a project doesn't have them, Rule 1 simply finds no overrides and falls back to skill defaults. +- check the existence of `.wiki/` / `.tasks/` on disk (мета в mappa, решение 14/15: вики/таски — сущности сервиса через `using-wiki` / `using-tasks`; файловый layout — легаси); if a project has neither, Rule 1 simply finds no overrides and falls back to skill defaults. ## Why this exists diff --git a/skills/setup-projects-meta/README.md b/skills/setup-projects-meta/README.md index 12c51ea..0bb53d8 100644 --- a/skills/setup-projects-meta/README.md +++ b/skills/setup-projects-meta/README.md @@ -88,6 +88,6 @@ Works on Windows under git-bash, Linux, macOS. cross-project task aggregation and shared-wiki query / ingest. - [`setup-context7`](../setup-context7/) — companion pattern for the context7 MCP plugin (similar 8-phase shape). -- [`setup-wiki`](../setup-wiki/), [`setup-tasks`](../setup-tasks/) — - per-project setup skills (in-repo `.wiki/` and `.tasks/`); orthogonal to - this skill, which sets up the cross-project layer. +- Per-project вики/таски живут в mappa (мета в сервисе, решения 14/15) — + setup-скилов `.wiki/`/`.tasks/` больше нет; операции — `using-wiki` / + `using-tasks`. diff --git a/skills/using-wiki/README.md b/skills/using-wiki/README.md index 09d9170..67d4c97 100644 --- a/skills/using-wiki/README.md +++ b/skills/using-wiki/README.md @@ -7,7 +7,8 @@ three named operations, with strict file formats that keep the wiki parseable and grep-friendly. `using-wiki` governs *usage* of an existing `.wiki/`. Initial creation and -migration to canon are owned by [`setup-wiki`](../setup-wiki/). +**Канал — mappa** (решение 14/15): вики = сущности `type=wiki` в сервисе +(см. SKILL.md v2.0.0). Файловый `.wiki/` — легаси; `setup-wiki` умер. > Renamed from `wiki-maintainer` at v1.0.0. @@ -19,7 +20,7 @@ migration to canon are owned by [`setup-wiki`](../setup-wiki/). - Any time the agent modifies a file under `.wiki/` — the workflow and formats below are mandatory. - If `.wiki/` is missing or non-canonical, this skill delegates to - [`setup-wiki`](../setup-wiki/) before doing anything else. + вики читается из mappa (`wiki_get`); ничего настраивать не нужно. ## Three layers (do not blur) @@ -136,7 +137,7 @@ Sections by type. Update on every ingest. | Ingest one doc | `sources/.md` (new) + 3–15 entity/concept/package pages + `index.md` + `log.md` | | Query | (read only) + optionally a new wiki page + `log.md` | | Lint | (read only) + `log.md` | -| Bootstrap / migrate | (delegated to [`setup-wiki`](../setup-wiki/)) | +| Новая вики проекта | первый ingest создаёт CLAUDE/index/log через wiki_create | ## Common mistakes @@ -152,7 +153,7 @@ Sections by type. Update on every ingest. - **Forgetting `index.md`.** Pages not listed there are invisible to future queries. - **Improvising layout when canon files are missing.** Hand off to - [`setup-wiki`](../setup-wiki/) instead of patching ad-hoc. + (setup-wiki умер: канал — mappa, страницы создаются wiki_create). ## When NOT to use @@ -174,9 +175,9 @@ Works on Windows under git-bash, Linux, macOS. ## See also -- [`setup-wiki`](../setup-wiki/) — companion, owns `.wiki/` creation and +- mappa — сервис-хост вики (`wiki.get`/`wiki.create`/`wiki.update`); canon migration. -- [`project-bootstrap`](../project-bootstrap/) — invokes `setup-wiki` for +- [`project-bootstrap`](../project-bootstrap/) — invokes mappa-режим для new projects. - Karpathy's LLM Wiki gist: