Merge pull request #3204 from AtCoder-NoviSteps/#3203

chore: Update docs (#3203)

Author: KATO-Hiro

AGENTS.md

@@ -2,6 +2,10 @@
 
 A web service for tracking submissions on AtCoder and other competitive programming sites, which are graded by difficulty (Q11-D6).
 
+## Guidelines
+
+Always prefer simplicity over pathological correctness. YAGNI, KISS, DRY. No backward-compat shims or fallback paths unless they come free without adding cyclomatic complexity.
+
 ## Tech Stack
 
 SvelteKit 2 + Svelte 5 (Runes) + TypeScript | PostgreSQL + Prisma | Flowbite Svelte + Tailwind 4 | Vitest + Playwright

CONTRIBUTING.md

@@ -252,11 +252,11 @@
 
    例:
 
-   `git commit -m ":sparkles: Add hoge feature (#998244353)"`
+   `git commit -m "feat: Add new feature (#998244353)"`
 
-   `git commit -m ":books: Update README (#1333)"`
+   `git commit -m "docs: Update README (#1333)"`
 
-   `git commit -m ":pencil2: Fix typo (#10007)"`
+   `git commit -m "chore: Fix typo (#10007)"`
 
 4. プルリクエストを作成する前に、加筆・修正した内容を確認します。
 

docs/guides/architecture.md

@@ -70,12 +70,12 @@ src/features/
 │   │   ├── grade-list/              # グレード別
 │   │   ├── detail/
 │   │   │   ├── statistics/          # AtCoder Problems の difficulty、JOI 難易度、AC人数 など
-│   │   │   ├── votes/               # AtCoder NoviSteps の難易度、タグを投票
 │   │   │   └── comments/            # (要確認) 管理者: 解説、一般ユーザ: コメント
 │   │   └── shared/
+├── votes/                           # AtCoder NoviSteps における難易度、タグを投票
 ├── admin/
 │   ├── components/
-│   │   ├── account_transfer/
+│   │   ├── account-transfer/
 │   │   ├── tasks-for-import/
 │   │   └── shared/
 │   ...
@@ -93,12 +93,12 @@ src/features/
 
 現在の `src/lib/` からの抽出候補:
 
-| Feature          | 抽出対象                                                                                                                                             |
-| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **tasks**        | `TaskTables/*`, `TaskGrades/*`, `stores/active_problem_list_tab.svelte.ts`（※ `TaskGradeList`, `TaskList` 等は複数ドメインで使うため `lib/` に残す） |
-| **admin**        | `TagForm`, `TagListForEdit`, `TaskForm`, `TaskListForEdit`, `services/tags.ts`, `services/task_tags.ts`                                              |
-| **auth**         | `AuthForm`, `utils/auth_forms.ts`, `types/auth_forms.ts`                                                                                             |
-| **user-profile** | `UserProfile`, `UserAccountDeletionForm`                                                                                                             |
+| Feature          | 抽出対象                                                                                                                             |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| **tasks**        | `TaskGrades/*`, `stores/active_problem_list_tab.svelte.ts`（※ `TaskGradeList`, `TaskList` 等は複数ドメインで使うため `lib/` に残す） |
+| **admin**        | `TagForm`, `TagListForEdit`, `TaskForm`, `TaskListForEdit`, `services/tags.ts`, `services/task_tags.ts`                              |
+| **auth**         | `AuthForm`, `utils/auth_forms.ts`, `types/auth_forms.ts`                                                                             |
+| **user-profile** | `UserProfile`, `UserAccountDeletionForm`                                                                                             |
 
 ### Feature 間の依存ルール