Files
skeleton/.opencode/rules/general.md
Worker Skeletton 5c9b4333da Unify OpenCode and Codex starter kits
- 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.
2026-05-25 14:11:00 +02:00

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.ts next 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:

  1. Re-read relevant feature spec
  2. Check git diff for uncommitted changes
  3. Continue from where you left off
  4. Never restart from scratch without checking progress