You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+14-8Lines changed: 14 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -74,8 +74,8 @@ Suggested order for phased work: `/analisar` (optional) → `/planejar` → `/ex
74
74
75
75
-**Astro** is the framework. It was chosen because this is content-first, not app-first. Ships minimal JS via island architecture.
76
76
-**React** is used only for interactive islands (quizzes, comparators, steppers, filters), not for page-level rendering.
77
-
-**CSS Modules + CSS Variables + design tokens**. No Tailwind. The Neo Brutalism visual language requires authorial control that utility-first CSS undermines.
78
-
-**CSS-first animations**. Decorative and state-transition animations must be pure CSS. JavaScript animation is reserved for _interactive physics_ (drag, pointer tracking, procedural motion): use `motion` (drag only) or bespoke `requestAnimationFrame` loops. Do not introduce other animation libraries (GSAP, anime, react-spring, etc) without explicit approval.
77
+
-**CSS Modules + CSS Variables + design tokens**. No Tailwind. The editorial visual language ("The Institute", see `REDESIGN.md`) requires authorial control that utility-first CSS undermines.
78
+
-**CSS-first animations**. Decorative and state-transition animations must be pure CSS, and calm: fades and small settles only — no springs, shake, or sound. JavaScript animation is reserved for _interactive physics_ (drag, pointer tracking, procedural motion) via bespoke `requestAnimationFrame` loops. Do not introduce animation libraries (GSAP, anime, react-spring, motion, etc) without explicit approval.
79
79
-**Content Collections** with schema validation for all session content (MDX with typed frontmatter).
80
80
81
81
### Key Architecture Decisions
@@ -111,13 +111,19 @@ The home page contains a compact foundations primer for "AI-Native Engineer", "A
111
111
112
112
Every session page follows a fixed template: hero → 30s summary → main explanation → why it matters → real example when useful → where it breaks → takeaway → references. Interactive blocks are used only when they clearly improve explanation, organization, or retention.
113
113
114
-
## Design System: Neo Brutalism
114
+
## Design System: The Institute (Editorial)
115
115
116
-
- High contrast, block layout, thick black borders, hard offset shadows (no blur, no glassmorphism, no gradients)
117
-
- Palette: warm light background, pure black, 2-3 vibrant accents (yellow, electric blue, acid green, or coral)
118
-
- Heavy-weight headlines, neutral readable body text
119
-
- Mobile-first: single column, reduced decoration, comfortable touch targets
120
-
- WCAG contrast compliance and visible focus states
116
+
The visual language is a quiet, typography-led editorial system inspired by institutional sites like mit.edu. Full art direction and rationale live in `REDESIGN.md`. It replaced the old Neo-Brutalist system.
117
+
118
+
- One accent only: signal red (`--color-accent`); everything else is paper, ink, and hairlines. Color never carries meaning alone (levels, statuses, and types are text labels).
119
+
- Surfaces: warm paper background, white raised surfaces, charcoal dark theme (never blue-graphite).
120
+
- Structure: 1px hairlines (`var(--line)`) and whitespace separate sections. No thick borders, no hard offset shadows — all `--shadow-*` tokens are `none`; `var(--shadow-overlay)` exists only for floating UI.
121
+
- Typography: Inter Tight for display/headings (`--font-display`, tracking -0.02em), Inter for body, Newsreader italic for ledes and pull quotes (`--font-serif`), JetBrains Mono for code.
122
+
- Brand mark: typographic wordmark preceded by a small red square; favicon is the red square on paper.
123
+
- Motion: calm only — fades and small settles with `var(--ease-standard)`. No springs, no screen shake, no audio.
124
+
- Patterns: `.kicker`micro-labels mark sections; badges are neutral hairline chips (`variant="accent"` reserved for true highlights); cards are flat with hairline borders and underline-on-hover titles; the inverted ink band is reserved for the manifesto moment.
125
+
- Mobile-first: single column, reduced decoration, comfortable touch targets.
126
+
- WCAG contrast compliance and visible focus states.
121
127
- Breakpoints: mobile ≤767px, tablet 768-1023px, desktop 1024px+, wide 1440px+
Copy file name to clipboardExpand all lines: ROADMAP.md
+24Lines changed: 24 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -216,3 +216,27 @@ Things we might do later, but absolutely not now:
216
216
- auth / user accounts
217
217
- CMS integration
218
218
- gamification
219
+
220
+
---
221
+
222
+
## Redesign Track: The Institute (Editorial)
223
+
224
+
Full visual redesign replacing Neo Brutalism with the editorial system defined in `REDESIGN.md`. Implemented as sequential commits on `main` (no PRs), validated and pushed once at the end.
-[ ] Migrate island CSS internals (ChapterNav, ChapterFooter, harness/*) to semantic tokens — they currently inherit the new look through the legacy aliases
242
+
-[ ] PLAN.md design-language sweep (historical discovery doc; design source of truth is now `REDESIGN.md` + `AGENTS.md`)
0 commit comments