chore: bootstrap project structure
- .wiki/ with canonical Karpathy layout (CLAUDE.md, index, log, overview, raw) - .tasks/ with canonical STATUS.md board - CLAUDE.md with skill triggers - Bootstrap manifest in .wiki/concepts/ Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
25
.tasks/STATUS.md
Normal file
25
.tasks/STATUS.md
Normal file
@@ -0,0 +1,25 @@
|
|||||||
|
# Task Board
|
||||||
|
_Updated: 2026-05-03_
|
||||||
|
|
||||||
|
<!--
|
||||||
|
Add one block per task, sorted by priority. Use the emoji status legend below.
|
||||||
|
Per-task deep context lives in .tasks/<task-slug>.md (created on demand by using-tasks).
|
||||||
|
|
||||||
|
Block format:
|
||||||
|
|
||||||
|
## 🔴 [task-slug] — short description
|
||||||
|
**Status:** active
|
||||||
|
**Where I stopped:** one sentence — the exact thought or action interrupted
|
||||||
|
**Next action:** one concrete step to resume immediately
|
||||||
|
**Blocker:** (only if blocked) what is preventing progress
|
||||||
|
**Branch:** git branch name
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Status legend:
|
||||||
|
🔴 Active — only one at a time
|
||||||
|
🟡 Paused — in progress, resumable
|
||||||
|
⚪ Ready — defined, not started
|
||||||
|
🟢 Done — kept until merged
|
||||||
|
🔵 Blocked — waiting on external input
|
||||||
|
-->
|
||||||
35
.wiki/CLAUDE.md
Normal file
35
.wiki/CLAUDE.md
Normal file
@@ -0,0 +1,35 @@
|
|||||||
|
# Wiki Schema — meeting-room
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
## Scope
|
||||||
|
|
||||||
|
This wiki is **project-level** — for knowledge specific to the meeting-room project:
|
||||||
|
- architecture decisions, backend design, UI patterns
|
||||||
|
- entities like roles, providers, scenario format
|
||||||
|
- concepts like brainstorm mode, roundtable mode, artifact generation
|
||||||
|
|
||||||
|
For cross-project knowledge (org structure, shared conventions) use the global `~/projects/.wiki/`.
|
||||||
|
|
||||||
|
## Page types
|
||||||
|
|
||||||
|
- `entities/` — discrete things: roles, providers, config schema.
|
||||||
|
- `concepts/` — recurring ideas, design decisions: brainstorm, roundtable, artifacts.
|
||||||
|
- `packages/` — code packages this project produces or consumes.
|
||||||
|
- `sources/` — one summary page per ingested external doc; 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
|
||||||
|
|
||||||
|
- Entities: roles (moderator, skeptic, idea_generator, analyst, boss, cso), providers (routerai, ollama_cloud)
|
||||||
|
- Concepts: brainstorm (1:1 with CSO), roundtable (multi-agent discussion), setup (pre-discussion config), artifacts (tasks, wiki, decisions)
|
||||||
|
- Packages: httpx, pyyaml (runtime); textual/fastapi (planned)
|
||||||
0
.wiki/concepts/.gitkeep
Normal file
0
.wiki/concepts/.gitkeep
Normal file
19
.wiki/concepts/bootstrap-manifest.md
Normal file
19
.wiki/concepts/bootstrap-manifest.md
Normal file
@@ -0,0 +1,19 @@
|
|||||||
|
---
|
||||||
|
title: Bootstrap Manifest
|
||||||
|
type: concept
|
||||||
|
updated: 2026-05-03
|
||||||
|
generator: project-bootstrap@1.5.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.5.0 | orchestrator |
|
||||||
|
| `setup-wiki` | 1.0.0 | wiki canonical layout |
|
||||||
|
| `setup-tasks` | 1.0.0 | tasks canonical layout |
|
||||||
|
| `project-discipline` | 0.1.0 | cross-project policy |
|
||||||
|
|
||||||
|
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. Updated on every ingest / new page.
|
||||||
|
|
||||||
|
## 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. Format:
|
||||||
|
|
||||||
|
```
|
||||||
|
## [YYYY-MM-DD] <op> | <one-line description>
|
||||||
|
```
|
||||||
|
|
||||||
|
Operations: `init`, `ingest`, `query`, `lint`, `refactor`, `decision`.
|
||||||
|
|
||||||
|
Parseable: `grep "^## \[" .wiki/log.md | tail -20`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## [2026-05-03] init | wiki bootstrapped via setup-wiki@1.0.0
|
||||||
27
.wiki/overview.md
Normal file
27
.wiki/overview.md
Normal file
@@ -0,0 +1,27 @@
|
|||||||
|
---
|
||||||
|
title: meeting-room overview
|
||||||
|
type: overview
|
||||||
|
updated: 2026-05-03
|
||||||
|
---
|
||||||
|
|
||||||
|
# meeting-room — overview
|
||||||
|
|
||||||
|
Multi-agent discussion framework — an interactive workspace where AI agents debate problems and produce structured artifacts.
|
||||||
|
|
||||||
|
## What it does
|
||||||
|
|
||||||
|
Meeting-room is the "office" in the `.meeting-room/` org structure. It runs multi-agent roundtable discussions (Moderator, Skeptic, Idea Generator, Analyst) and supports interactive brainstorm sessions with a CSO (Chief Strategy Officer) agent.
|
||||||
|
|
||||||
|
## Key components
|
||||||
|
|
||||||
|
- **Brainstorm** — 1:1 discussion with CSO for raw idea exploration
|
||||||
|
- **Roundtable** — multi-agent discussion with configurable participants, models, and tools
|
||||||
|
- **Setup** — interactive pre-discussion configuration (participants, models, agenda, artifacts)
|
||||||
|
- **Artifacts** — structured output: tasks → `.tasks/`, knowledge → `.wiki/`, decisions → markdown
|
||||||
|
|
||||||
|
## Tech stack
|
||||||
|
|
||||||
|
- Python 3.11+, httpx, pyyaml
|
||||||
|
- Custom backend (round-robin agent orchestration with tool support)
|
||||||
|
- OpenAI-compatible API (multi-provider: RouterAI, Ollama Cloud, etc.)
|
||||||
|
- Planned: FastAPI + WebSocket for Web UI
|
||||||
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 outside the repo, register them here:
|
||||||
|
|
||||||
|
```
|
||||||
|
- short-name → /absolute/path/to/source
|
||||||
|
```
|
||||||
0
.wiki/sources/.gitkeep
Normal file
0
.wiki/sources/.gitkeep
Normal file
11
CLAUDE.md
Normal file
11
CLAUDE.md
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
# 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
|
||||||
|
we're on Windows
|
||||||
Reference in New Issue
Block a user