OpeItcLoc03/skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(project-bootstrap): согласовать doc с mappa-agnostic шаблоном (task:2024 review-minor)

Browse Source 
Inline-зеркало шаблона, пояснение об инъекции, строка session sync в
deps-check, README. Строка session handoff (легаси) оставлена — актуальна
для проектов, несущих её в AGENTS.md.
This commit is contained in:
vitya
2026-09-02 14:38:35 +03:00
parent d2059b42bd
commit 5c726eb5ec
2 changed files with 11 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
skills/project-bootstrap/README.md
View File

@@ -39,7 +39,7 @@ Karpathy / `.tasks/` (см. using-wiki/using-tasks, legacy-раздел).
| `README.md` | minimal stub | Skipped if file exists. |
| вики | 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. |
| `AGENTS.md` | `assets/AGENTS.md.template` | **Canon** — mappa-agnostic generic triggers (caveman, pull remote before work, tdd, interns, recommend, platform). Mappa-специфичные триггеры (`inbox monitor: raise on start`, `session sync: write to mappa`, `use project wiki`, `use task management system`, `check across all projects`) инжектятся через mappa-bootstrap (Step 5.7.2). 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 generic 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. |

17
skills/project-bootstrap/SKILL.md
View File

@@ -389,9 +389,6 @@ Template contents (`assets/AGENTS.md.template` — source of truth):
# Agent instructions. Each line is a trigger for an installed skill.
talk like a caveman
use project wiki
use task management system
check across all projects
pull remote before work
follow tdd-criteria
delegate to interns when allowed
@@ -399,10 +396,15 @@ recommend, don't menu
we're on Windows
```
The `check across all projects` trigger activates the **mappa** tooling
(`mcp__mappa__*`) — cross-project boards, shared wiki and the project
registry live in mappa. The file-based `projects-meta-mcp` and its skills
(`using-projects-meta`, `setup-projects-meta`, `meta-host-routing`, `setup-wiki`,
Mappa-специфичные триггеры (`check across all projects`, `inbox monitor:
raise on start`, `use project wiki`, `use task management system`, `session
sync: write to mappa`) **не в шаблоне** — инжектятся через mappa-bootstrap
(Step 5.7.2), project-bootstrap mappa-agnostic. `check across all projects`
активирует **mappa** tooling (`mcp__mappa__*`) — cross-project boards, shared
wiki и реестр проектов живут в mappa.
The file-based `projects-meta-mcp` and its skills (`using-projects-meta`,
`setup-projects-meta`, `meta-host-routing`, `setup-wiki`,
`setup-tasks`) were removed 2026-08-25; the shared `projects-wiki` files are
stubs «не читать, не править» — канон mappa shared-scope.
@@ -516,6 +518,7 @@ Mismatch between template and map → silent gaps in the recommendation.
| `use project wiki` | `mappa-knowledge` | skill | см. mappa-bootstrap (репо mappa) | `cd <mappa-repo> && bash skills/mappa-bootstrap/assets/install.sh` |
| `use task management system` | `mappa-task-work` | skill | см. mappa-bootstrap (репо mappa) | `cd <mappa-repo> && bash skills/mappa-bootstrap/assets/install.sh` |
| `inbox monitor: raise on start` | `mappa-session-orient` | skill | см. mappa-bootstrap (репо mappa) | `cd <mappa-repo> && bash skills/mappa-bootstrap/assets/install.sh` |
| `session sync: write to mappa` | `mappa-session-orient` | skill | см. mappa-bootstrap (репо mappa) | `cd <mappa-repo> && bash skills/mappa-bootstrap/assets/install.sh` |
| `we're on Windows` / `we're on Linux` / `we're on macOS` | `active-platform` | skill | `~/.claude/skills/active-platform/SKILL.md` | `bash scripts/install.sh active-platform` |
### Algorithm