alexei.dolgolyov
04fe8124fc
SKILL.md shrunk from 1444 → 245 lines via progressive disclosure. Detailed
workflow content extracted into 8 reference files loaded only when needed.
Critical fixes
- Replace `claude -p` bash invocation with Task-tool spawn patterns (broken in
VS Code extension, no hook/billing/telemetry inheritance, fails on PowerShell)
- Fix malformed Phase Progress Log table (header had 6 cols, row had 5 —
every PLAN.md generated from the template was broken)
- Drop `/mnt/skills/public/` frontend-design path (Claude.ai sandbox only,
never existed in CLI / VS Code / JetBrains installs)
High-impact additions
- Resume / abort triggers added to skill description ("continue feature",
"resume planning", "pick up where we left off")
- Strategy behavior centralized in references/modes-and-strategies.md (was
duplicated in 5+ places — drift was inevitable)
- references/resumability-and-abort.md adds a clean abort flow
- references/agent-spawning.md covers Task-tool patterns, parallel phases
with git worktrees, MODEL_PROFILE cost overrides, local-only repo handling,
and optional code-review-graph MCP integration
- Phase implementer agents now MUST scan CONTEXT.md `## Failed Approaches`
before writing code (#1 source of duplicated mistakes across phases)
- Test writer / implementer division of labor made explicit (implementer
writes happy-path tests, test writer adds adversarial coverage)
- New `## New Tooling Introduced` section in CONTEXT.md prevents tech-stack
staleness across long features
- Local-only repo detection (probe `git remote -v` in Phase 1)
- Cost transparency: documented expected $5-25/feature and added
`MODEL_PROFILE=fast|balanced|thorough` overrides
Structure
- SKILL.md: thin orchestrator (workflow outline + 18 key rules + agent
table + Task-tool intro + cost note)
- references/: 8 files for on-demand detail
- modes-and-strategies.md
- resumability-and-abort.md
- discovery-and-planning.md (Phase 0 + plan templates with FIXED table)
- implementation-loop.md (Phase N + amendments)
- context-management.md (4-tier system)
- final-review-and-merge.md (final phase + rollback)
- agent-spawning.md (Task tool / worktrees / cost / local-only repos)
- tech-stack-analysis.md (slimmed — detection only, references rules
system instead of duplicating best practices)
- agents/: phase-implementer.md and phase-implementer-frontend.md updated
with mandatory Failed Approaches scan; test-writer.md gains division-of-
labor section; other 5 agents unchanged
Claude Code Facts
Last updated: 2026-05-16
A collection of interesting and useful facts, tips, tools, and guides for working with Claude and Claude Code.
Contents
Claude Code Tools & Extensions
MCP servers, skills, and plugins that extend Claude Code — including Context7 (library docs) and AST Index (fast code search).
Gitea Release Workflow (Minimal)
Minimal Gitea Actions workflow: push a v* tag → create a Gitea release with optional RELEASE_NOTES.md. No builds, no artifacts — just a release entry.
CI/CD for Python Apps on Gitea
Reusable reference for building CI pipelines, release automation, and installer packaging for Python apps on Gitea — covering lint/test workflows, cross-compiled Windows builds (embedded Python + NSIS), Linux tarballs, Docker images, and Gitea REST API release management.
Windows Code Signing for Open-Source Projects
Review of code signing options for Windows executables — Azure Trusted Signing ($9.99/mo, immediate SmartScreen trust), SignPath.io (free but GitHub-only), SSL.com, Certum, and self-signed. Includes CI/CD integration examples for Gitea Actions.
Gitea Act Runner — Worker Capacity (TrueNAS)
How to configure parallel job capacity for Gitea Act Runner on TrueNAS. Covers the CONFIG_FILE env var requirement, custom config.yaml mount, and capacity tuning.