chore: bootstrap project structure (.tasks, .wiki, CLAUDE.md)
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).
This commit is contained in:
8
.tasks/STATUS.md
Normal file
8
.tasks/STATUS.md
Normal file
@@ -0,0 +1,8 @@
|
|||||||
|
# Task Board
|
||||||
|
_Updated: 2026-05-06_
|
||||||
|
|
||||||
|
Per-task deep context lives in `.tasks/<task-slug>.md` (created on demand by `using-tasks`).
|
||||||
|
|
||||||
|
**Status legend:** 🔴 active · 🟡 paused · ⚪ ready · 🟢 done · 🔵 blocked · ⚫ cancelled
|
||||||
|
|
||||||
|
---
|
||||||
24
.wiki/CLAUDE.md
Normal file
24
.wiki/CLAUDE.md
Normal file
@@ -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
|
||||||
|
|
||||||
|
<!-- factory-specific naming idioms — fill in as the project takes shape. -->
|
||||||
0
.wiki/concepts/.gitkeep
Normal file
0
.wiki/concepts/.gitkeep
Normal file
21
.wiki/concepts/bootstrap-manifest.md
Normal file
21
.wiki/concepts/bootstrap-manifest.md
Normal file
@@ -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`.
|
||||||
0
.wiki/entities/.gitkeep
Normal file
0
.wiki/entities/.gitkeep
Normal file
23
.wiki/index.md
Normal file
23
.wiki/index.md
Normal file
@@ -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
|
||||||
|
|
||||||
|
<!-- (none yet) -->
|
||||||
|
|
||||||
|
## Concepts
|
||||||
|
|
||||||
|
<!-- (none yet) -->
|
||||||
|
|
||||||
|
## Packages
|
||||||
|
|
||||||
|
<!-- (none yet) -->
|
||||||
|
|
||||||
|
## Sources
|
||||||
|
|
||||||
|
<!-- (none yet) -->
|
||||||
15
.wiki/log.md
Normal file
15
.wiki/log.md
Normal file
@@ -0,0 +1,15 @@
|
|||||||
|
# Wiki Log
|
||||||
|
|
||||||
|
Append-only operation log. One entry per operation. Format:
|
||||||
|
|
||||||
|
```
|
||||||
|
## [YYYY-MM-DD] <op> | <one-line description>
|
||||||
|
```
|
||||||
|
|
||||||
|
Operations: `init`, `ingest`, `query`, `lint`, `refactor`, `decision`.
|
||||||
|
|
||||||
|
Parseable: `grep "^## \[" .wiki/log.md | tail -20`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## [2026-05-06] init | bootstrap empty wiki via project-bootstrap
|
||||||
5
.wiki/overview.md
Normal file
5
.wiki/overview.md
Normal file
@@ -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).
|
||||||
0
.wiki/packages/.gitkeep
Normal file
0
.wiki/packages/.gitkeep
Normal file
11
.wiki/raw/README.md
Normal file
11
.wiki/raw/README.md
Normal file
@@ -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
|
||||||
|
```
|
||||||
0
.wiki/sources/.gitkeep
Normal file
0
.wiki/sources/.gitkeep
Normal file
12
CLAUDE.md
Normal file
12
CLAUDE.md
Normal file
@@ -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
|
||||||
Reference in New Issue
Block a user