From 5327befef6a2bd1065570c03af76665a5fed3be8 Mon Sep 17 00:00:00 2001 From: Parfii-bot Date: Sun, 17 May 2026 20:39:06 +0800 Subject: [PATCH] =?UTF-8?q?docs(=5Fblocks):=20INDEX.md=20=E2=80=94=20?= =?UTF-8?q?=D1=80=D0=B5=D0=B5=D1=81=D1=82=D1=80=2084=20=D0=B1=D0=BB=D0=BE?= =?UTF-8?q?=D0=BA=D0=BE=D0=B2=20=D0=B4=D0=BB=D1=8F=20assembler?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Авто-сгенерирован из _blocks/*.md по категориям префикса: API / AUTH / CI / DB / DEPLOY / DOCS / DOMAIN / MODE / OBS / PATH / RULE / SCRAPER / SECURITY / STACK / TEST + прочие. Каждая запись: `name` — первая H1-строка файла. Использование в _manifests/.toml: blocks = ["baseline", "rule-pre-dev-gate", "api-anthropic", ...] Assembler читает блоки из _blocks/, склеивает в финальный _generated/.md. Новый блок = просто .md в _blocks/. Регенерация INDEX.md — TODO build-index.sh скрипт (сейчас сгенерирован вручную bash циклом). --- _blocks/INDEX.md | 147 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 147 insertions(+) create mode 100644 _blocks/INDEX.md diff --git a/_blocks/INDEX.md b/_blocks/INDEX.md new file mode 100644 index 0000000..3a4b68f --- /dev/null +++ b/_blocks/INDEX.md @@ -0,0 +1,147 @@ +# Реестр блоков KeiSeiKit + +> SSoT для assembler. Все блоки доступные для `blocks = [...]` в `_manifests/.toml`. +> Авто-генерируется из `_blocks/*.md`. Каждый файл = атомарный кубик (Constructor Pattern). + +Пример: +```toml +blocks = ["baseline", "rule-pre-dev-gate", "api-anthropic"] +``` + +## По категориям + +### API + +- `api-anthropic` — API — Anthropic (Claude) +- `api-apify` — API — Apify (web scraping platform) +- `api-elevenlabs` — API — ElevenLabs (voice) +- `api-fal-ai` — API — fal.ai (image / video / 3D) +- `api-graphql` — API — GraphQL (schema-first, DataLoader, subscriptions, persisted queries) +- `api-openapi-first` — API — OpenAPI-First (3.1 as single source of truth) +- `api-rest-conventions` — API — REST Conventions (verbs, status codes, resources, idempotency, ETag) +- `api-versioning-pagination-ratelimit` — API — Versioning, Pagination, Rate Limiting + +### AUTH + +- `auth-authorization` — AUTH — Authorization (RBAC / ABAC / ReBAC) +- `auth-oauth2-oidc` — AUTH — OAuth2 + OIDC (Authorization Code + PKCE) +- `auth-passkeys` — AUTH — Passkeys (WebAuthn / FIDO2) +- `auth-sessions` — AUTH — Sessions & Cookies (+JWT tradeoff) + +### CI + +- `ci-forgejo-actions` — CI — Forgejo Actions (self-hosted, Tailscale-only admin) +- `ci-github-actions` — CI — GitHub Actions (OIDC, matrix, cache, reusable workflows) +- `ci-release-automation` — CI — Release automation (SemVer, changelog, tagging) +- `ci-security-gate` — CI — Security gate (secrets, SCA, SBOM, semgrep, licenses) + +### DB + +- `db-drizzle` — DB — Drizzle ORM (TypeScript) patterns +- `db-migration-hygiene` — DB — Migration hygiene (universal) +- `db-postgres` — DB — PostgreSQL (current major — 17 as of 2026-04) patterns +- `db-sqlite` — DB — SQLite (prod-suitable) patterns +- `db-sqlx` — DB — SQLx (Rust) patterns + +### DEPLOY + +- `deploy-aws-ec2` — DEPLOY — AWS EC2 (Instance Connect + Elastic IP) +- `deploy-cloudflare` — DEPLOY — Cloudflare (Workers / Pages / R2 / KV) +- `deploy-docker` — DEPLOY — Docker +- `deploy-hetzner-cloud` — DEPLOY — Hetzner Cloud (CX22 / CAX11 + TF + Cloud Firewall) +- `deploy-local-only` — DEPLOY — LOCAL ONLY (sensitive / pre-disclosure project) +- `deploy-modal` — DEPLOY — Modal (GPU compute) +- `deploy-vps-generic` — DEPLOY — Generic VPS (provider-agnostic cloud-init + ssh-first-contact) + +### DOCS + +- `docs-architecture-diagrams` — DOCS — Architecture diagrams (Mermaid) +- `docs-claude-md` — DOCS — `CLAUDE.md` (project bootstrap template) +- `docs-decisions-adr` — DOCS — `DECISIONS.md` / ADR template (MADR 4.0) +- `docs-readme-template` — DOCS — Public `README.md` scaffold +- `docs-runbook` — DOCS — Operational runbook template + +### DOMAIN + +- `domain-has-secrets` — DOMAIN — Secrets handling +- `domain-ml-training` — DOMAIN — ML Training +- `domain-paid-apis` — DOMAIN — Paid APIs (Anthropic / OpenAI / fal.ai / Apify / Modal / AWS / GCP / ElevenLabs) + +### MODE + +- `mode-devils-advocate` — MODE — Devil's Advocate +- `mode-first-principles` — MODE — First Principles +- `mode-matrix` — MODE — Agent × Cognitive-Mode Matrix +- `mode-maximalist` — MODE — Maximalist +- `mode-minimalist` — MODE — Minimalist +- `mode-skeptic` — MODE — Skeptic + +### OBS + +- `obs-metrics` — OBSERVABILITY — Metrics (Prometheus + OTel + RED/USE) +- `obs-structured-logs` — OBSERVABILITY — Structured logs (JSON-lines) +- `obs-traces` — OBSERVABILITY — Distributed traces (OpenTelemetry + W3C traceparent) + +### PATH + +- `path-user-hooks` — Path atom — user-hooks +- `path-user-memory` — Path atom — user-memory +- `path-user-rules` — Path atom — user-rules + +### RULE + +- `rule-double-audit` — DOUBLE AUDIT PROTOCOL (mandatory when 3+ files touched) +- `rule-error-budget` — ERROR BUDGET — 3-Level Escalation +- `rule-math-first` — MATH FIRST (mandatory for ML / physics / theory work) +- `rule-pre-dev-gate` — PRE-DEV GATE — three checks before any new code +- `rule-pure-click-contract` — Pure-Click Contract +- `rule-test-first` — TEST-FIRST + +### SCRAPER + +- `scraper-free-tier` — DOMAIN — Scrapers Tier 1 (free APIs + open-source) +- `scraper-paid-tier` — DOMAIN — Scrapers Tier 3 (Apify / Bright Data paid) +- `scraper-unified-output` — DOMAIN — Scraper unified output invariant + +### SECURITY + +- `security-audit-logging` — SECURITY — Audit Logging (auditd + journald forwarding) +- `security-firewall-ufw` — SECURITY — Firewall (ufw default-deny + rate limiting + nftables alt) +- `security-patching` — SECURITY — Patching (unattended-upgrades + needrestart + reboot window) +- `security-ssh-hardening` — SECURITY — SSH Hardening (sshd_config.d/99-kei.conf) +- `security-tls-caddy` — SECURITY — TLS via Caddy (automatic ACME, HTTP-01 / DNS-01) + +### STACK + +- `stack-astro` — STACK — Astro 6 (Content + Marketing + Islands) +- `stack-embedded-stm32` — STACK — Embedded Rust STM32 (embassy / cortex-m) +- `stack-fastapi-postgres` — STACK — FastAPI + async SQLAlchemy 2.0 + PostgreSQL +- `stack-flutter` — STACK — Flutter + Riverpod + Clean Architecture +- `stack-go-server` — STACK — Go server +- `stack-nextjs` — STACK — Next.js 15/16 (App Router + TS + Server Components) +- `stack-python-ml` — STACK — Python ML (PyTorch / JAX) +- `stack-react-vite` — STACK — Vite + React 19 + TypeScript (SPA) +- `stack-rust-axum` — STACK — Rust HTTP server (axum + tokio + sqlx) +- `stack-rust-cli` — STACK — Rust CLI / tooling +- `stack-sveltekit` — STACK — SvelteKit (Svelte 5 Runes + TS) +- `stack-swift-ios` — STACK — Swift iOS (UIKit / SwiftUI hybrid) +- `stack-swift-spm` — STACK — Swift SPM executable (macOS) +- `stack-tailwind` — STACK — Tailwind CSS 4 (compositional add-on) + +### TEST + +- `test-e2e` — TEST — End-to-end (Playwright browser automation) +- `test-fuzz` — TEST — Fuzzing (input-space exploration) +- `test-load` — TEST — Load / performance testing (baseline → profile → fix) +- `test-property` — TEST — Property-based testing (invariants + shrinking) + +### Прочие (без категорийного префикса) + +- `baseline` — BASELINE — inherit from Main Claude (never violate) +- `evidence-grading` — EVIDENCE GRADING +- `memory-protocol` — MEMORY PROTOCOL +- `pipeline-5phase-template` — Pipeline 5-Phase Wizard Template (shared preamble) + +--- + +Всего блоков: 84.