chore: bootstrap project structure
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
40
.gitignore
vendored
Normal file
40
.gitignore
vendored
Normal file
@@ -0,0 +1,40 @@
|
||||
# Dependencies
|
||||
node_modules/
|
||||
.venv/
|
||||
__pycache__/
|
||||
*.pyc
|
||||
|
||||
# Build outputs
|
||||
dist/
|
||||
build/
|
||||
*.egg-info/
|
||||
|
||||
# Environment
|
||||
.env
|
||||
.env.local
|
||||
.env.*.local
|
||||
|
||||
# IDE
|
||||
.idea/
|
||||
.vscode/
|
||||
*.swp
|
||||
*.swo
|
||||
|
||||
# OS
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
|
||||
# Logs
|
||||
*.log
|
||||
logs/
|
||||
|
||||
# AI обвеска — слой 2: переопределяем глобальный ~/.config/git/ignore
|
||||
# для своих репо (см. global wiki concept meta-out-of-repo)
|
||||
!.claude/
|
||||
!.tasks/
|
||||
!.wiki/
|
||||
!.brainstorm/
|
||||
!.archive/
|
||||
!.mcp/
|
||||
!.mcp.json
|
||||
!MEMORY.md
|
||||
25
.tasks/STATUS.md
Normal file
25
.tasks/STATUS.md
Normal file
@@ -0,0 +1,25 @@
|
||||
# Task Board
|
||||
_Updated: 2026-05-22_
|
||||
|
||||
<!--
|
||||
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
|
||||
-->
|
||||
24
.wiki/CLAUDE.md
Normal file
24
.wiki/CLAUDE.md
Normal file
@@ -0,0 +1,24 @@
|
||||
# Wiki Schema — board-viewer
|
||||
|
||||
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 this 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; 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
|
||||
|
||||
<!-- Fill in as the project takes shape — what counts as an entity here, which packages exist, naming idioms specific to this codebase. -->
|
||||
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-22
|
||||
generator: project-bootstrap@1.11.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.11.0 | orchestrator |
|
||||
| `setup-wiki` | 1.0.0 | wiki canonical layout |
|
||||
| `setup-tasks` | 1.0.0 | tasks canonical layout |
|
||||
| `project-discipline` | 0.1.1 | cross-project policy |
|
||||
| `setup-interns` | 0.4.0 | interns MCP server install (one-time, per machine) |
|
||||
| `using-interns` | 0.3.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. 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-22] init | wiki bootstrapped via setup-wiki@1.0.0
|
||||
9
.wiki/overview.md
Normal file
9
.wiki/overview.md
Normal file
@@ -0,0 +1,9 @@
|
||||
---
|
||||
title: board-viewer overview
|
||||
type: overview
|
||||
updated: 2026-05-22
|
||||
---
|
||||
|
||||
# board-viewer — overview
|
||||
|
||||
<!-- Replace with a high-level description: what this project does, who it's for, the main components. -->
|
||||
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
14
CLAUDE.md
Normal file
14
CLAUDE.md
Normal file
@@ -0,0 +1,14 @@
|
||||
# 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
|
||||
follow tdd-criteria
|
||||
delegate to interns when allowed
|
||||
recommend, don't menu
|
||||
we're on Windows
|
||||
13
README.md
Normal file
13
README.md
Normal file
@@ -0,0 +1,13 @@
|
||||
# board-viewer
|
||||
|
||||
## About
|
||||
|
||||
Read-only HTML kanban-viewer над `.tasks/*.md` + Gitea API. Рендерит 5-колоночную доску (⚪ open / 🟡 in-progress / 🟣 paused / 🔴 blocked / 🟢 done) по агрегированным таскам из всех проектов.
|
||||
|
||||
Хост: `board.kzntsv.site` за traefik на VDS. Обновление: cron-тик ~5 мин, перегенерация статической HTML.
|
||||
|
||||
Design: see `.wiki/concepts/` (after promote from `.workshop/.brainstorm/board-viewer.md`).
|
||||
|
||||
## Quick start
|
||||
|
||||
<!-- TBD после первого impl-prototype -->
|
||||
Reference in New Issue
Block a user