- Add .shared/prompts/ with tool-neutral prompts - Add .opencode/config/project.md, rules/, skills/ from opencode-kit - Add .codex/config/project.md from codex-kit - Copy .shared/prompts/ to both .opencode/prompts/ and .codex/prompts/ - Add features/INDEX.md and features/README.md - Update README with unified structure The two original starter kits are now redundant.
1017 B
1017 B
General Rules
General development rules for the AI Coding Starter Kit.
Feature Tracking
- All features MUST be tracked in
features/INDEX.md - Feature IDs are sequential: PROJ-1, PROJ-2, etc.
- Never skip IDs or use non-sequential numbering
Git Workflow
- Commits:
feat(PROJ-X): description,fix(PROJ-X): description - Never commit secrets, API keys, or credentials
- Always read file before modifying (never assume contents)
File Structure
- Feature specs:
features/PROJ-X-feature-name.md - Tests: co-located next to source (
*.test.tsnext to*.ts) - shadcn/ui components:
src/components/ui/(NEVER recreate)
State Management
- State lives in files, not in memory
- Re-read files when context is compacted
- All progress in markdown files (INDEX.md, feature specs)
Context Recovery
If context is compacted:
- Re-read relevant feature spec
- Check
git difffor uncommitted changes - Continue from where you left off
- Never restart from scratch without checking progress