docs: split AGENTS.md into core policy and on-demand playbooks

2602.12670 and 2602.11988 findings favoring curated, minimal, modular guidance over comprehensive always-on context
This commit is contained in:
plebeius
2026-02-23 20:39:58 +08:00
parent 849ff18a8b
commit e06d367468
6 changed files with 350 additions and 390 deletions
@@ -0,0 +1,26 @@
# Commit and Issue Format
Use this when proposing or implementing meaningful code changes.
## Commit Suggestion Format
- **Title:** Conventional Commits style, short, wrapped in backticks.
- Use `perf` (not `fix`) for performance optimizations.
- **Description:** Optional 2-3 informal sentences describing the solution. Concise, technical, no bullet points.
Example:
> **Commit title:** `fix: correct date formatting in timezone conversion`
>
> Updated `formatDate()` in `date-utils.ts` to properly handle timezone offsets.
## GitHub Issue Suggestion Format
- **Title:** As short as possible, wrapped in backticks.
- **Description:** 2-3 informal sentences describing the problem (not the solution), as if still unresolved.
Example:
> **GitHub issue:**
> - **Title:** `Date formatting displays incorrect timezone`
> - **Description:** Comment timestamps show incorrect timezones when users view posts from different regions. The `formatDate()` function doesn't account for user's local timezone settings.