mirror of
https://github.com/ksyasuda/SubMiner.git
synced 2026-03-20 12:11:28 -07:00
sudacode
cc5d270b8e
- Stats dashboard redesign design and implementation plans - Episode detail and Anki card link design - Internal knowledge base restructure - Backlog tasks for testing, verification, and occurrence tracking
1.0 KiB
1.0 KiB
Core Beliefs
Status: active
Last verified: 2026-03-13
Owner: Kyle Yasuda
Read when: making decisions about agent ergonomics, doc structure, or repository guidance
Agent-First Principles
- Progressive disclosure beats giant injected context.
AGENTS.mdshould map the territory, not duplicate it.- Canonical internal guidance belongs in versioned docs near the code.
- Plans are first-class while active work is happening.
- Mechanical checks beat social convention when the boundary matters.
- Small focused docs are easier to trust, update, and verify.
- User-facing docs and internal operating docs should not blur together.
What This Means Here
- Start from
AGENTS.md, then move intodocs/. - Prefer links to canonical docs over repeating long instructions.
- Keep architecture and workflow docs in separate pages so updates stay targeted.
- When a page becomes long or multi-purpose, split it.