From 8f8230475882f48b1becf7437942e2ddfe49a5bb Mon Sep 17 00:00:00 2001 From: Marcos Paulo Date: Sun, 6 Sep 2026 00:02:51 +0000 Subject: [PATCH] fix(full-guide): restore omitted guide sections Restore the builder, hands-on, and verification content lost by task 15d, including the legacy bilingual pairs.\n\nDo not alter legacy files or verification assertions. --- src/pages/full-guide.astro | 274 +++++++++++++++++++++++++++++++++---- 1 file changed, 247 insertions(+), 27 deletions(-) diff --git a/src/pages/full-guide.astro b/src/pages/full-guide.astro index 6c43689..f34ecf1 100644 --- a/src/pages/full-guide.astro +++ b/src/pages/full-guide.astro @@ -82,6 +82,31 @@ const labels = { source: { en: 'GITHUB SOURCE ↗', pt: 'FONTE NO GITHUB ↗' }, }, }; +const builderSteps: Record< + string, + { title: { en: string; pt: string }; tagline: { en: string; pt: string } } +> = { + observe: { + title: { en: 'Observe', pt: 'Observar' }, + tagline: { en: 'find repeated friction', pt: 'encontre atrito repetido' }, + }, + trigger: { + title: { en: 'Define trigger', pt: 'Definir gatilho' }, + tagline: { en: 'route precisely', pt: 'roteie com precisão' }, + }, + scaffold: { + title: { en: 'Choose anatomy', pt: 'Escolher anatomia' }, + tagline: { en: 'only needed files', pt: 'apenas arquivos necessários' }, + }, + write: { + title: { en: 'Write guidance', pt: 'Escrever orientação' }, + tagline: { en: 'decisions, not trivia', pt: 'decisões, não trivialidades' }, + }, + validate: { + title: { en: 'Validate', pt: 'Validar' }, + tagline: { en: 'test real behavior', pt: 'teste comportamento real' }, + }, +}; const selectorData = { phases, workers, @@ -690,7 +715,16 @@ const base = import.meta.env.BASE_URL; >MEDIUMdefault start - )) + ['observe', 'trigger', 'scaffold', 'write', 'validate'].map((id) => { + const step = skillWorkflow[id]; + return ( + + ); + }) }
@@ -819,7 +893,39 @@ const base = import.meta.env.BASE_URL; > -
+ +
+ AFTER REAL USE
+ observe failure→sharpen one rule→retest behavior→keep it narrow +
@@ -955,14 +1061,38 @@ const base = import.meta.env.BASE_URL;

Start with a deliberately incomplete static task board. Run one prompt as written, - reset, then run the skill-enabled version. + reset, then run the skill-enabled version. Compare diff size, verification evidence, and + unnecessary complexity.

- Open the starter →Open the rules lab → +
+ Open the starter →Clone from Gitea → +
+ Open the rules lab →Clone from Gitea → +
+
+ THE MISSING FEATUREAdd All / Open / Done filters that survive reload and browser navigation.
+ STACK HTML · CSS · JavaScript DEPENDENCIES none FILES 3 +
@@ -981,6 +1111,33 @@ const base = import.meta.env.BASE_URL; Same contract · explicit working methods · stronger proof
+
+ COMPARE THE RUNS
+ 01 + Files changed +
+ 02 + New dependencies +
+ 03 + Checks actually run +
+ 04 + Evidence returned +

@@ -1017,21 +1174,84 @@ const base = import.meta.env.BASE_URL;
Verificationrun each gate separately +
+
+

Checks become evidence

+ Three layers.
Run each one alone. +

+

+ Run a gate on its own line, print its exit code, attach the output. The result is the + deliverable. +

01 · STATIC

Lint and types

- Format, lint, type-check. Fast and scoped to one file. -

pnpm lint; echo "lint=$?" + Format, lint, type-check. Fast and scoped to one file. Run on every save. +

pnpm lint; echo "lint=$?" pnpm typecheck; echo "typecheck=$?"
02 · BEHAVIOR

Unit and contract

Tests that repeat. Run before claiming done. -

pnpm test; echo "test=$?" +

pnpm test; echo "test=$?" cd services/api && go test ./...
03 · INTEGRATION

Real UI and API

- Drive the actual UI, API, or browser. -

pnpm check:ui; echo "ui=$?" + Drive the actual UI, API, or browser. Slower and flakier — only this catches mobile + overflow and a missing 404. +

pnpm check:ui; echo "ui=$?" TURBO_FORCE=true pnpm e2e
-
+
+ FOUR WAYS A GREEN REPORT IS FALSE
+
+ 1
+ Pipe a gate

+ tail, grep, or head hide the real exit code — a pipeline returns the last command's + status. +

+
+
+ 2
+ Swallow a rejection

+ A silent {'.catch(() => {})'} hides a panic, an upstream limit, or a partial + failure. +

+
+
+ 3
+ Trust the cache

+ Turbo caches results. A gate that "passes" may not have run — use TURBO_FORCE=true. +

+
+
+ 4
+ Skip the third layer

+ Lint and unit can both be green while the page breaks on mobile and the API never + returns 404. +

+
+
+
+
+ RUN IT YOURSELF · two labs, under 10 minutes each
+ Path A · verification lab

+ Fill the four-row comparison strip on the starter. Run A naively, Run B with $gate-discipline and $webapp-testing. +

Open the starter →Clone ↗ git.marcospaulo.dev.br/.../src/branch/pages/hands-on/starterPath B · rules lab

+ Toggle every rule off, run the prompt. Toggle every rule on, run it again. Compare + diff size, gate invocations, and the names of checks the agent names back. +

Open the starter →Clone ↗ git.marcospaulo.dev.br/.../src/branch/pages/hands-on/rules +
+