commit d0dc686a654568c03553e8f17be02cc0b041152d Author: vitya Date: Fri May 22 08:10:40 2026 +0300 chore: bootstrap project structure Co-Authored-By: Claude Opus 4.7 (1M context) diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..7869f4f --- /dev/null +++ b/.gitignore @@ -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 diff --git a/.tasks/STATUS.md b/.tasks/STATUS.md new file mode 100644 index 0000000..8d64b39 --- /dev/null +++ b/.tasks/STATUS.md @@ -0,0 +1,25 @@ +# Task Board +_Updated: 2026-05-22_ + + diff --git a/.wiki/CLAUDE.md b/.wiki/CLAUDE.md new file mode 100644 index 0000000..8eee6d2 --- /dev/null +++ b/.wiki/CLAUDE.md @@ -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 + + 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..8a9cf42 --- /dev/null +++ b/.wiki/concepts/bootstrap-manifest.md @@ -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`. 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..37543c1 --- /dev/null +++ b/.wiki/index.md @@ -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 + + + +## Concepts + + + +## Packages + + + +## Sources + + diff --git a/.wiki/log.md b/.wiki/log.md new file mode 100644 index 0000000..b12660a --- /dev/null +++ b/.wiki/log.md @@ -0,0 +1,15 @@ +# Wiki Log + +Append-only operation log. Format: + +``` +## [YYYY-MM-DD] | +``` + +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 diff --git a/.wiki/overview.md b/.wiki/overview.md new file mode 100644 index 0000000..fd5a8a6 --- /dev/null +++ b/.wiki/overview.md @@ -0,0 +1,9 @@ +--- +title: board-viewer overview +type: overview +updated: 2026-05-22 +--- + +# board-viewer — overview + + 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..4bce818 --- /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 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..829cbb7 --- /dev/null +++ b/CLAUDE.md @@ -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 diff --git a/README.md b/README.md new file mode 100644 index 0000000..5195f04 --- /dev/null +++ b/README.md @@ -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 + +