Skip to content

Refresh agent instructions and add planning artifacts#196

Merged
hendripermana merged 1 commit into
mainfrom
docs/refresh-agent-instructions
Jun 15, 2026
Merged

Refresh agent instructions and add planning artifacts#196
hendripermana merged 1 commit into
mainfrom
docs/refresh-agent-instructions

Conversation

@hendripermana

Copy link
Copy Markdown
Owner

Summary

  • Condense AGENTS.md from 43k → 36k chars (under 40k /doctor limit)
  • Replace verbose 6-point development philosophy with 4 clear engineering principles: Durable, Grounded, Verified, Honest
  • Remove all shadcn references — DS::* is the sole component API (ADR-0008)
  • Update stale dependency versions to match current lockfiles (Biome 2.4.16, Sidekiq 8.1.6, Stripe 19.2.0, aws-sdk-s3 1.224.0, Turbo 2.0.23, Brakeman 8.0.5)
  • Add companion documents section pointing to CONTEXT.md, docs/adr/, docs/agents/
  • Update product framing from "Indonesian finance app" to global core + regional coverage (ADR-0012)
  • Enforce TDD workflow (/tdd skill) and Playwright/Chrome E2E verification in pre-PR checklist
  • Replace npm → pnpm references throughout
  • Add CONTEXT.md domain glossary with canonical ubiquitous language
  • Add 12 architecture decision records under docs/adr/
  • Add agent harness, domain docs, issue tracker conventions, and triage labels under docs/agents/
  • Gitignore issues/ directory (WIP specs not ready to ship)

Test plan

  • Verify CLAUDE.md symlink still resolves correctly
  • Verify wc -c AGENTS.md is under 40,000 chars
  • Verify grep -i shadcn AGENTS.md returns no results
  • Verify no issues/ files appear in git status
  • Run /doctor and confirm the large CLAUDE.md warning is gone

🤖 Generated with Claude Code

- Condense AGENTS.md from 43k to 36k chars (under 40k limit)
- Replace verbose 6-point philosophy with 4 clear principles:
  Durable, Grounded, Verified, Honest
- Remove all shadcn references (DS::* is sole component API per ADR-0008)
- Update dependency versions to match lockfiles (Biome 2.4.16,
  Sidekiq 8.1.6, Stripe 19.2.0, aws-sdk-s3 1.224.0, Turbo 2.0.23)
- Add companion documents section (CONTEXT.md, docs/adr/, docs/agents/)
- Update product framing to global core + regional coverage (ADR-0012)
- Enforce TDD workflow and E2E verification in pre-PR checklist
- Replace npm references with pnpm throughout
- Add CONTEXT.md domain glossary
- Add 12 architecture decision records (docs/adr/)
- Add agent harness, domain docs, issue tracker, triage labels (docs/agents/)
- Gitignore issues/ directory (WIP specs not ready to ship)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@hendripermana
hendripermana merged commit ba28fa0 into main Jun 15, 2026
5 checks passed
@hendripermana
hendripermana deleted the docs/refresh-agent-instructions branch June 15, 2026 09:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant