From ecddcdfb6df69b1e8f683f056c243272c93abac7 Mon Sep 17 00:00:00 2001 From: vitya Date: Wed, 6 May 2026 21:13:44 +0300 Subject: [PATCH] chore: bootstrap project structure (.tasks, .wiki, CLAUDE.md) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds canonical Karpathy LLM Wiki layout, .tasks/STATUS.md board, and CLAUDE.md trigger set. Brings factory repo into projects-meta indexing eligibility (sync-runner.ts:69 โ€” needs .tasks/STATUS.md or .wiki/index.md on default branch). Bootstrap-manifest at .wiki/concepts/bootstrap-manifest.md records skill versions used (project-bootstrap@1.7.0, layouts inline-fallback from setup-wiki@1.0.0 / setup-tasks@1.0.0). --- .tasks/STATUS.md | 8 ++++++++ .wiki/CLAUDE.md | 24 ++++++++++++++++++++++++ .wiki/concepts/.gitkeep | 0 .wiki/concepts/bootstrap-manifest.md | 21 +++++++++++++++++++++ .wiki/entities/.gitkeep | 0 .wiki/index.md | 23 +++++++++++++++++++++++ .wiki/log.md | 15 +++++++++++++++ .wiki/overview.md | 5 +++++ .wiki/packages/.gitkeep | 0 .wiki/raw/README.md | 11 +++++++++++ .wiki/sources/.gitkeep | 0 CLAUDE.md | 12 ++++++++++++ 12 files changed, 119 insertions(+) create mode 100644 .tasks/STATUS.md create mode 100644 .wiki/CLAUDE.md create mode 100644 .wiki/concepts/.gitkeep create mode 100644 .wiki/concepts/bootstrap-manifest.md create mode 100644 .wiki/entities/.gitkeep create mode 100644 .wiki/index.md create mode 100644 .wiki/log.md create mode 100644 .wiki/overview.md create mode 100644 .wiki/packages/.gitkeep create mode 100644 .wiki/raw/README.md create mode 100644 .wiki/sources/.gitkeep create mode 100644 CLAUDE.md diff --git a/.tasks/STATUS.md b/.tasks/STATUS.md new file mode 100644 index 0000000..9c3971e --- /dev/null +++ b/.tasks/STATUS.md @@ -0,0 +1,8 @@ +# Task Board +_Updated: 2026-05-06_ + +Per-task deep context lives in `.tasks/.md` (created on demand by `using-tasks`). + +**Status legend:** ๐Ÿ”ด active ยท ๐ŸŸก paused ยท โšช ready ยท ๐ŸŸข done ยท ๐Ÿ”ต blocked ยท โšซ cancelled + +--- diff --git a/.wiki/CLAUDE.md b/.wiki/CLAUDE.md new file mode 100644 index 0000000..b333730 --- /dev/null +++ b/.wiki/CLAUDE.md @@ -0,0 +1,24 @@ +# Wiki Schema โ€” factory + +Project-specific wiki conventions. Read this before any wiki operation. + +This wiki follows Karpathy's LLM Wiki pattern: +**https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f** + +The `using-wiki` skill enforces the workflow and file formats. This file overrides the skill where they conflict. + +## Page types + +- `entities/` โ€” discrete things the project tracks (people, services, modules). +- `concepts/` โ€” recurring ideas, design decisions, gotchas. +- `packages/` โ€” code packages this project produces or consumes. +- `sources/` โ€” one summary page per ingested external doc; frontmatter carries `ingested:` and `raw_path:`. +- `overview.md` โ€” single project-wide overview. + +## Naming + +- `kebab-case.md`, **Latin only**. Transliterate Cyrillic in filenames; keep the original title in the H1 + frontmatter. + +## Domain conventions + + diff --git a/.wiki/concepts/.gitkeep b/.wiki/concepts/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/concepts/bootstrap-manifest.md b/.wiki/concepts/bootstrap-manifest.md new file mode 100644 index 0000000..55481c1 --- /dev/null +++ b/.wiki/concepts/bootstrap-manifest.md @@ -0,0 +1,21 @@ +--- +title: Bootstrap Manifest +type: concept +updated: 2026-05-06 +generator: project-bootstrap@1.7.0 +--- + +# Bootstrap Manifest + +Skills used to initialize this project's `.wiki/` and `.tasks/` layout, with their versions at install time. + +| Skill | Version | Role | +|---|---|---| +| `project-bootstrap` | 1.7.0 | orchestrator | +| `setup-wiki` | 1.0.0 | wiki canonical layout (inline-fallback: invoked from project-bootstrap directly, schema verbatim from setup-wiki@1.0.0) | +| `setup-tasks` | 1.0.0 | tasks canonical layout (inline-fallback: same as above) | +| `project-discipline` | 0.1.0 | cross-project policy | +| `setup-interns` | 0.2.0 | interns MCP server install (one-time, per machine) | +| `using-interns` | 0.2.0 | interns runtime policy + per-session permission grant | + +This file is overwritten if `project-bootstrap` is re-run on the same project. For history, use `git log .wiki/concepts/bootstrap-manifest.md`. diff --git a/.wiki/entities/.gitkeep b/.wiki/entities/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/index.md b/.wiki/index.md new file mode 100644 index 0000000..9725429 --- /dev/null +++ b/.wiki/index.md @@ -0,0 +1,23 @@ +# Wiki Index + +Catalog of all wiki pages. One line per page, organized by type. The agent updates this on every ingest. + +## Overview + +- [overview.md](overview.md) โ€” project overview + +## Entities + + + +## Concepts + + + +## Packages + + + +## Sources + + diff --git a/.wiki/log.md b/.wiki/log.md new file mode 100644 index 0000000..3b33625 --- /dev/null +++ b/.wiki/log.md @@ -0,0 +1,15 @@ +# Wiki Log + +Append-only operation log. One entry per operation. Format: + +``` +## [YYYY-MM-DD] | +``` + +Operations: `init`, `ingest`, `query`, `lint`, `refactor`, `decision`. + +Parseable: `grep "^## \[" .wiki/log.md | tail -20`. + +--- + +## [2026-05-06] init | bootstrap empty wiki via project-bootstrap diff --git a/.wiki/overview.md b/.wiki/overview.md new file mode 100644 index 0000000..5925646 --- /dev/null +++ b/.wiki/overview.md @@ -0,0 +1,5 @@ +# factory โ€” overview + +Software-factory bootstrap for the OpeItcLoc03 fleet โ€” installs and updates meta-infrastructure (`.common/`, `.organization/`, `.templates/`, `.wiki/`, `.tasks/`, `.meeting-room/`, claude-skills, MCP servers) on a clean machine in a single, idempotent, cross-platform run. + +Architecture lives in `concepts/factory-bootstrap.md`. L0 (pre-Claude shell scripts), L1 (`factory` Go binary + `factory.yaml` manifest), L2 (existing `setup-*` skills as the install backbone for runtime services). diff --git a/.wiki/packages/.gitkeep b/.wiki/packages/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/.wiki/raw/README.md b/.wiki/raw/README.md new file mode 100644 index 0000000..69613f8 --- /dev/null +++ b/.wiki/raw/README.md @@ -0,0 +1,11 @@ +# Raw Sources + +**Immutable.** Read, never edit. The only allowed modification is appending a `> Status:` blockquote when the user explicitly asks for a status audit. + +Place raw inputs here โ€” articles, transcripts, PDFs, screenshots โ€” exactly as they came in. The agent reads from `raw/`, writes summaries into `../sources/`, and never modifies raw files. + +For large or path-sensitive sources that live outside the repo, register them here: + +``` +- short-name โ†’ /absolute/path/to/source +``` diff --git a/.wiki/sources/.gitkeep b/.wiki/sources/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..dd42cb0 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,12 @@ +# CLAUDE.md +# Agent instructions. Each line is a trigger for an installed skill. + +talk like a caveman +use superpowers +use project wiki +use task management system +check across all projects +pull remote before work +follow project discipline +delegate to interns when allowed +we're on Windows