theinterneti/TTA.dev / .claude/skills/create-atomic-note
create-atomic-note
UnverifiedUse this skill when saving a single-topic documentation note to docs/kb-exports/ for later knowledge base ingestion.
Skill: create-atomic-note
Purpose
Save a single-topic documentation note to docs/kb-exports/ for periodic ingestion into the TTA-notes knowledge base.
When to Use
After completing any significant task: new feature, bug fix, architectural decision, research finding, or outstanding TODO.
Rules
- One topic per file. Two topics = two files.
- Filename:
YYYY-MM-DD_<kebab-case-slug>.md- Example:
2026-03-04_persistence-primitives-design.md
- Example:
- YAML frontmatter is mandatory. Every note must include all required fields (see template).
- Length limit: ~300 lines max. If longer, split into multiple notes.
- Never write narrative prose for its own sake. Be dense and factual.
Required Frontmatter
---
type: <note-type>
priority: <1|2|3>
status: draft
tags: [tta-dev]
source_agent: claude-code
date: YYYY-MM-DD
related_files: []
---
Field Reference
| Field | Values | Notes |
|---|---|---|
type | architecture decision bug-fix feature research todo | Pick the closest match |
priority | 1 2 3 | 1 = action needed now, 2 = medium, 3 = reference/low |
status | draft review stable | New notes start as draft |
tags | array | Always include tta-dev; add topic tags: dev-todo learning-todo ops-todo template-todo |
source_agent | string | claude-code, cline, copilot, gemini, etc. |
date | YYYY-MM-DD | Today's date |
related_files | array of repo paths | Files this note documents; can be empty |
Content Structure
# <Short, Specific Title>
## Summary
One paragraph: what this is and why it matters.
## Context
What led to this? What problem was being solved?
## Decision / Finding
The actual content — be specific and dense.
## Consequences / Next Steps
What does this enable? What should happen next?
Full Example
Filename: 2026-03-04_uow-abstract-base-class-design.md
---
type: architecture
priority: 2
status: draft
tags: [tta-dev, dev-todo]
source_agent: claude-code
date: 2026-03-04
related_files:
- platform/primitives/src/tta_dev_primitives/persistence/uow.py
- tests/unit/test_uow.py
---
# Unit of Work: Abstract Base Class Design
## Summary
AbstractUnitOfWork defines the contract for transactional boundaries in TTA.dev
persistence primitives. All concrete UoW implementations (Supabase, in-memory, fake)
inherit from it.
## Context
Needed a standard interface so workflow primitives can swap persistence backends
without changing business logic. Inspired by the Repository + UoW pattern from
Domain-Driven Design.
## Decision / Finding
- `AbstractUnitOfWork` exposes `commit()`, `rollback()`, and `__aenter__`/`__aexit__`
- `FakeUnitOfWork` ships in the testing module for use in unit tests
- No direct Supabase coupling in the abstract class
## Consequences / Next Steps
- Any new persistence backend just implements AbstractUnitOfWork
- TODO: add Dolt backend (see platform/dolt/)
Where to Save
Always save to: docs/kb-exports/<YYYY-MM-DD_slug>.md
The TTA-notes repo ingests this directory periodically. Do not create subdirectories inside kb-exports/.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 464k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 196k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |