Skip to content

Commit 470a921

Browse files
claudeSkords-01
claude
authored and
Skords-01
committed
docs(docs): prettier formatting and link display-text fixes after split
1 parent d5ebe0e commit 470a921

12 files changed

Lines changed: 112 additions & 119 deletions

File tree

‎docs/04-governance/governance/hard-rules-matrix.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,8 +34,8 @@
3434
| **13** | [No raw-palette light/dark `className` pairs](./rules/13-no-raw-palette-light-dark-pairs.md) | `lint-enforced-convention` | 🛑 blocker | `apps/web/src/**`<br>`apps/mobile/src/**` | **ESLint** `sergeant-design/no-raw-dark-palette (error)` | [AGENTS #13](../../../AGENTS.md#hard-rules-do-not-break) |
3535
| **14** | [Visible focus indicators must use `focus-visible:`, not `focus:`](./rules/14-focus-visible-not-focus.md) | `lint-enforced-convention` | 🛑 blocker | `apps/web/src/**` | **ESLint** `sergeant-design/prefer-focus-visible (error)` | [AGENTS #14](../../../AGENTS.md#hard-rules-do-not-break) |
3636
| **15** | [Read governance before coding; update docs alongside code; internal docs in Ukrainian](./rules/15-governance-and-doc-language.md) | `lint-enforced-convention` | 🛑 blocker | `**/*` | **CI** `pnpm lint:governance-sync (errors on dangling apps/packages/scripts refs in non-aspirational docs)`<br>**CI** `pnpm docs:check-freshness-coverage`<br>**CI** `pnpm lint:hard-rules-registry (this rule's own enforcer)`<br>**PR template** .github/PULL_REQUEST_TEMPLATE.md (Hard Rule #15 checkboxes) | [AGENTS #15](../../../AGENTS.md#hard-rules-do-not-break) |
37-
| **16** | [Typography scale — semantic styles + 12px floor](./rules/16-typography-scale-12px-floor.md) | `lint-enforced-convention` | 🛑 blocker | `apps/web/src/**`<br>`packages/design-tokens/**` | **Convention** packages/design-tokens/tailwind-preset.js → plugins.semanticTypography (.text-style-\* utilities are the canonical type slots)<br>**Doc** docs/05-design/design/design-system/02-typography.md § Типографічна шкала | [`docs/90-work/audits/archive/2026-04-28-ux-ui-audit.md`](../../../docs/90-work/audits/archive/2026-04-28-ux-ui-audit.md)<br>[AGENTS #16](../../../AGENTS.md#hard-rules-do-not-break) |
38-
| **17** | [Animation budget — max 2 concurrent, 3 tiers](./rules/17-animation-budget.md) | `lint-enforced-convention` | 🛑 blocker | `apps/web/src/**`<br>`packages/design-tokens/**` | **Convention** AGENTS.md § Hard rules #17 (AMBIENT/RESPONSE/CELEBRATE tiers; max 1 AMBIENT + 1 RESPONSE simultaneously; stagger ≤ 30 ms × N capped at 150 ms; CELEBRATE only on milestones 7/30/100/365)<br>**Doc** docs/05-design/design/design-system/05-motion-offline-error.md § 14. Motion & Animation | [w3.org/WAI/WCAG22/Understanding/animation-from-interactions.html](https://www.w3.org/WAI/WCAG22/Understanding/animation-from-interactions.html)<br>[AGENTS #17](../../../AGENTS.md#hard-rules-do-not-break) |
37+
| **16** | [Typography scale — semantic styles + 12px floor](./rules/16-typography-scale-12px-floor.md) | `lint-enforced-convention` | 🛑 blocker | `apps/web/src/**`<br>`packages/design-tokens/**` | **Convention** packages/design-tokens/tailwind-preset.js → plugins.semanticTypography (.text-style-\* utilities are the canonical type slots)<br>**Doc** docs/05-design/design/design-system/02-typography.md § Типографічна шкала | [`docs/90-work/audits/archive/2026-04-28-ux-ui-audit.md`](../../../docs/90-work/audits/archive/2026-04-28-ux-ui-audit.md)<br>[AGENTS #16](../../../AGENTS.md#hard-rules-do-not-break) |
38+
| **17** | [Animation budget — max 2 concurrent, 3 tiers](./rules/17-animation-budget.md) | `lint-enforced-convention` | 🛑 blocker | `apps/web/src/**`<br>`packages/design-tokens/**` | **Convention** AGENTS.md § Hard rules #17 (AMBIENT/RESPONSE/CELEBRATE tiers; max 1 AMBIENT + 1 RESPONSE simultaneously; stagger ≤ 30 ms × N capped at 150 ms; CELEBRATE only on milestones 7/30/100/365)<br>**Doc** docs/05-design/design/design-system/05-motion-offline-error.md § 14. Motion & Animation | [w3.org/WAI/WCAG22/Understanding/animation-from-interactions.html](https://www.w3.org/WAI/WCAG22/Understanding/animation-from-interactions.html)<br>[AGENTS #17](../../../AGENTS.md#hard-rules-do-not-break) |
3939
| **18** | [Module-size discipline — `max-lines: 600` for web TS/TSX and server TS/JS](./rules/18-module-size-discipline-600.md) | `active-initiative` | 🛑 blocker | `apps/web/src/**`<br>`apps/server/src/**` | **Convention** eslint.config.js → max-lines: [error, { max: 600, skipBlankLines: true, skipComments: true }] (scoped to apps/web/src/**/\*.{ts,tsx} and apps/server/src/**/\*.{js,ts}; tests, **tests** exempt)<br>**Doc** docs/90-work/initiatives/archive/\_0001-module-decomposition.md (allowlist + Phase 2 decomposition queue) | [`docs/90-work/initiatives/archive/_0001-module-decomposition.md`](../../../docs/90-work/initiatives/archive/_0001-module-decomposition.md)<br>[AGENTS #18](../../../AGENTS.md#hard-rules-do-not-break) |
4040
| **19** | [Strict-mode flag canonical — `noUncheckedIndexedAccess: true` по всьому monorepo](./rules/19-strict-mode-flag-canonical.md) | `active-initiative` | 🛑 blocker | `apps/**/tsconfig.json`<br>`packages/**/tsconfig.json` | **CI** `node tools/tsconfig-guard/check.mjs (run by pnpm lint)`<br>**Convention** tools/tsconfig-guard/allowlist.json — every override of a GUARDED strict-family flag MUST have an entry with path/option/value/reason/expires/owner<br>**Doc** docs/90-work/initiatives/archive/\_0012-perfect-strictness-rollout.md (rollout plan, baselines, criteria DONE) | [`docs/90-work/initiatives/archive/_0012-perfect-strictness-rollout.md`](../../../docs/90-work/initiatives/archive/_0012-perfect-strictness-rollout.md)<br>[`docs/90-work/tech-debt/frontend.md`](../../../docs/90-work/tech-debt/frontend.md)<br>[AGENTS #19](../../../AGENTS.md#hard-rules-do-not-break) |
4141
| **20** | [No OpenClaw PATs in production](./rules/20-no-openclaw-pats-in-production.md) | `blocker-invariant` | 🛑 blocker | `apps/server/src/env.ts`<br>`apps/server/src/env/env.ts`<br>`apps/server/src/modules/openclaw/**` | **Test** apps/server/src/env/**tests**/assertStartupEnv.test.ts (Hard Rule #20 suite)<br>**Convention** apps/server/src/env/env.ts → assertStartupEnv() throws when OPENCLAW_GITHUB_PAT or Git_PAT is present in production<br>**Doc** docs/00-start/playbooks/rotate-openclaw-credentials.md | [`docs/90-work/initiatives/stack-pulse-2026-05/pr-06-openclaw-github-app.md`](../../../docs/90-work/initiatives/stack-pulse-2026-05/pr-06-openclaw-github-app.md)<br>[AGENTS #20](../../../AGENTS.md#hard-rules-do-not-break) |

‎docs/05-design/design/design-system.md‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -24,13 +24,13 @@
2424

2525
Монолітний документ розбито на 5 тематичних файлів у [`design-system/`](./design-system/):
2626

27-
| Файл | Розділи | Зміст |
28-
| ---- | ------- | ----- |
29-
| [`01-tokens-colors.md`](./design-system/01-tokens-colors.md) | §1, §2, §9 | Принципи, кольорові токени, WCAG AA контраст |
30-
| [`02-typography.md`](./design-system/02-typography.md) | §3 | Типографічна шкала (`text-style-*`, tier-2, Prose) |
31-
| [`03-spacing-elevation-theming.md`](./design-system/03-spacing-elevation-theming.md) | §4, §7, §8 | Spacing, радіуси, тіні, мобільні брейкпоінти, темна тема / HC |
32-
| [`04-components.md`](./design-system/04-components.md) | §5, §6, §10, §11, §12, §13, §16, §18, §19 | Примітиви UI, Focus/a11y, Coding rules, Gestures, DropdownMenu, CommandPalette |
33-
| [`05-motion-offline-error.md`](./design-system/05-motion-offline-error.md) | §14, §15 | Motion tokens, Animation choreography, Offline/Empty/Error патерни |
27+
| Файл | Розділи | Зміст |
28+
| ------------------------------------------------------------------------------------ | ----------------------------------------- | ------------------------------------------------------------------------------ |
29+
| [`01-tokens-colors.md`](./design-system/01-tokens-colors.md) | §1, §2, §9 | Принципи, кольорові токени, WCAG AA контраст |
30+
| [`02-typography.md`](./design-system/02-typography.md) | §3 | Типографічна шкала (`text-style-*`, tier-2, Prose) |
31+
| [`03-spacing-elevation-theming.md`](./design-system/03-spacing-elevation-theming.md) | §4, §7, §8 | Spacing, радіуси, тіні, мобільні брейкпоінти, темна тема / HC |
32+
| [`04-components.md`](./design-system/04-components.md) | §5, §6, §10, §11, §12, §13, §16, §18, §19 | Примітиви UI, Focus/a11y, Coding rules, Gestures, DropdownMenu, CommandPalette |
33+
| [`05-motion-offline-error.md`](./design-system/05-motion-offline-error.md) | §14, §15 | Motion tokens, Animation choreography, Offline/Empty/Error патерни |
3434

3535
---
3636

@@ -89,8 +89,8 @@ Hard Rules + ESLint rules.
8989
→ [`design-system/02-typography.md`](./design-system/02-typography.md)
9090

9191
- [§3 Типографічна шкала](./design-system/02-typography.md#3-типографічна-шкала)
92-
- [text-style-* tier-1](./design-system/02-typography.md#семантичні-text-style--ютиліті-tier-1-fluid)
93-
- [Канонічна text-* шкала tier-2](./design-system/02-typography.md#канонічна-text--шкала-tier-2--окремі-утиліти)
92+
- [text-style-\* tier-1](./design-system/02-typography.md#семантичні-text-style--ютиліті-tier-1-fluid)
93+
- [Канонічна text-\* шкала tier-2](./design-system/02-typography.md#канонічна-text--шкала-tier-2--окремі-утиліти)
9494
- [Prose](./design-system/02-typography.md#prose--sharedcomponentsuiprose)
9595

9696
### Spacing, Elevation та Theming

‎docs/90-work/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,6 @@
1919
> на правонаступника — у `archive/` переноситься лише повністю superseded
2020
> матеріал (див. процес у кожному tracker-README).
2121
22-
Зведена матриця hardening-карток (stack-pulse-2026-05 + _0008 + _0009): [`initiatives/hardening-matrix.md`](./initiatives/hardening-matrix.md).
22+
Зведена матриця hardening-карток (stack-pulse-2026-05 + \_0008 + \_0009): [`initiatives/hardening-matrix.md`](./initiatives/hardening-matrix.md).
2323

2424
Назад до кореня: [`docs/README.md`](../README.md).

‎docs/90-work/initiatives/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -175,7 +175,7 @@ CI-гейт `lint:initiative-status-sync` (`scripts/check-initiative-status-sync
175175

176176
## Зведена матриця hardening-карток
177177

178-
Швидкий огляд усіх hardening-карток (stack-pulse-2026-05 + _0008 + _0009) — що зроблено, що відкрите: [`hardening-matrix.md`](./hardening-matrix.md).
178+
Швидкий огляд усіх hardening-карток (stack-pulse-2026-05 + \_0008 + \_0009) — що зроблено, що відкрите: [`hardening-matrix.md`](./hardening-matrix.md).
179179

180180
## Джерела
181181

0 commit comments

Comments
 (0)