Skip to content

docs: UI foundation documentation set (specs, ADRs, skills, agent instructions) - #116

Open
evertonschuster wants to merge 1 commit into
mainfrom
docs/002-ui-foundation-markdown
Open

docs: UI foundation documentation set (specs, ADRs, skills, agent instructions)#116
evertonschuster wants to merge 1 commit into
mainfrom
docs/002-ui-foundation-markdown

Conversation

@evertonschuster

Copy link
Copy Markdown
Owner

Por quê

Split fora da PR #115 — que traz o código
da UI foundation do admin-frontend — para que os 36 arquivos .md que essa branch muda possam
ser revisados no próprio ritmo, sem competir com a leitura do diff de código.

Nenhum arquivo de código muda nesta PR.

O que entra

Categoria Arquivos
Skills novas .claude/skills/agenza-{a11y-review,api-contract,frontend-slice,ptbr-copy,tenant-isolation,testing,ui-primitive}/**
Instruções de agente AGENTS.md e CLAUDE.md (raiz e apps/admin-frontend/), .github/copilot-instructions.md
ADRs novas 0039 (Base UI), 0040 (tema 3 estados), 0041 (arquivos de instrução de IA reinstaurados), mais o índice em docs/adr/README.md
Spec da feature apps/admin-frontend/specs/002-ui-foundation/{spec,plan,tasks}.md + checklists/acceptance.md
Docs de arquitetura apps/admin-frontend/docs/ARCHITECTURE.md, apps/admin-frontend/.specify/memory/constitution.md
READMEs raiz e apps/admin-frontend/

Trade-off aceito

As ADRs e a spec descrevem a fundação de UI que a #115 implementa em código. Se esta PR mergear
primeiro, a main fica temporariamente com documentação de uma feature cujo código ainda não
está lá — até a #115 também mergear. Aceito deliberadamente para permitir revisão em faixas
separadas.

🤖 Generated with Claude Code

Every markdown file this feature branch (002-ui-foundation) changes relative
to main, split into its own PR so it can be reviewed on its own track,
separately from the admin-frontend code in #115:

- New skill workflows: .claude/skills/agenza-{a11y-review,api-contract,
  frontend-slice,ptbr-copy,tenant-isolation,testing,ui-primitive}/
- Agent instruction files: root and admin-frontend AGENTS.md/CLAUDE.md,
  .github/copilot-instructions.md
- New ADRs: 0039 (Base UI primitives), 0040 (three-state theme),
  0041 (AI instruction files reinstated) and docs/adr/README.md's index
- The 002-ui-foundation feature's spec, plan, tasks and acceptance checklist
- Updated apps/admin-frontend/docs/ARCHITECTURE.md and
  .specify/memory/constitution.md
- Root and admin-frontend README.md

No code changes. The ADRs, spec and tasks describe the admin-frontend UI
foundation that #115 implements — until that PR also merges, main will have
documentation for a feature whose code isn't there yet, which is an accepted,
temporary tradeoff for reviewing docs and code on separate tracks.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Sep 6, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 45 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Team

Run ID: da593922-72d6-4ab2-b059-111bb012249e

📥 Commits

Reviewing files that changed from the base of the PR and between e377c98 and 8dfaccd.

📒 Files selected for processing (36)
  • .claude/skills/agenza-a11y-review/SKILL.md
  • .claude/skills/agenza-a11y-review/references/automation.md
  • .claude/skills/agenza-a11y-review/references/checklist.md
  • .claude/skills/agenza-api-contract/SKILL.md
  • .claude/skills/agenza-api-contract/references/errors.md
  • .claude/skills/agenza-frontend-slice/SKILL.md
  • .claude/skills/agenza-frontend-slice/references/api-integration.md
  • .claude/skills/agenza-frontend-slice/references/pages.md
  • .claude/skills/agenza-ptbr-copy/SKILL.md
  • .claude/skills/agenza-ptbr-copy/references/formatting.md
  • .claude/skills/agenza-ptbr-copy/references/states.md
  • .claude/skills/agenza-tenant-isolation/SKILL.md
  • .claude/skills/agenza-tenant-isolation/references/backend.md
  • .claude/skills/agenza-tenant-isolation/references/frontend.md
  • .claude/skills/agenza-testing/SKILL.md
  • .claude/skills/agenza-testing/references/patterns.md
  • .claude/skills/agenza-ui-primitive/SKILL.md
  • .claude/skills/agenza-ui-primitive/references/interaction.md
  • .claude/skills/agenza-ui-primitive/references/tokens.md
  • .github/copilot-instructions.md
  • AGENTS.md
  • CLAUDE.md
  • README.md
  • apps/admin-frontend/.specify/memory/constitution.md
  • apps/admin-frontend/AGENTS.md
  • apps/admin-frontend/CLAUDE.md
  • apps/admin-frontend/README.md
  • apps/admin-frontend/docs/ARCHITECTURE.md
  • apps/admin-frontend/specs/002-ui-foundation/checklists/acceptance.md
  • apps/admin-frontend/specs/002-ui-foundation/plan.md
  • apps/admin-frontend/specs/002-ui-foundation/spec.md
  • apps/admin-frontend/specs/002-ui-foundation/tasks.md
  • docs/adr/0039-admin-frontend-base-ui-primitives.md
  • docs/adr/0040-admin-frontend-three-state-theme.md
  • docs/adr/0041-ai-instruction-files-reinstated.md
  • docs/adr/README.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

evertonschuster added a commit that referenced this pull request Sep 7, 2026
Same change as 002-ui-foundation@a4fce93, synced here to keep this code-only
PR (#117) current with what #115 already carries — no markdown, per this
branch's own split from #116.

- Six destination pages and the new ProtectedAppShell (composes
  ProtectedRoute + AppShell) become react-router's native
  `lazy: () => import(...)` routes instead of static imports.
- LoginPage/AuthCallbackPage stay eager: they share @/features/auth's barrel
  with useAuth, already imported without lazy elsewhere, so a dynamic import
  there can't isolate them into their own chunk (confirmed by Rollup's
  INEFFECTIVE_DYNAMIC_IMPORT warning).
- HydrateFallback on the root route is a <main> wrapping a real <h1>, not a
  bare <div> — the first version tripped 3 axe violations
  (landmark-one-main, page-has-heading-one, region) during the brief window
  it's on screen before the first route's chunk resolves, caught by the real
  e2e a11y suite in CI (not reproducible in the unit-test harness, which
  scans an isolated container rather than the full document).

Entry chunk: 646 kB -> 348 kB (-46%). Full suite (tsc/eslint/prettier/
vitest+coverage/build) green; coverage unchanged.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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