transformer-causal-attention-page#105
Conversation
…ntion as a first-class attention variant]
… causal attention page
…n show up on attention discovery surfaces]
…for the page contract and nearby links
|
Addressed transformer-causal-attention-page-004. Changes:
Validation:
|
|
Mergeability follow-up on the current head:\n\n- confirmed there was no new blocking PR conversation feedback to address\n- re-ran local validation on the reviewed head: bun run typecheck |
|
Mergeability follow-up on commit c046e0b:
This addresses the failing coverage and test path behind verify-phase-1-route-search-ux, where the spawned verifier process was crashing on ENOENT for src/content/docs when coverage ran it from a temp fixture root. Validation:
|
|
Mergeability follow-up on commit 5a606a3:
Validation:
|
|
Mergeability follow-up on commit 5a606a35f0c73d608a3ce35650f5f2d52bf5db64:\n\n- fixed the failing \ Actions job by isolating the static search bootstrap fixtures onto suite-specific URLs\n- this prevents \ from reusing a cached exported index across unrelated Bun test files that replace \n- updated the raw/static search suites that previously shared the same bootstrap cache key\n\nValidation:\n- \bun test v1.3.13 (bf2e2cec)\n- \bun run typecheck |
|
Mergeability follow-up on commit 8077ab33d79f15ba8cd4f81e0f0dc4276e05268a:
Validation:
|
|
Mergeability follow-up on commit 7137b29:
Validation:
|
|
Mergeability follow-up on commit 958c8c4:
Validation:
|
|
Mergeability follow-up on commit 958c8c47c2c9f4498e8015c40987d6660c7dcd23:\n\n- addressed the failing \ job on the reviewed head, which was timing out at \ in the static export search verifier\n- hardened the header-search dialog probe so it recognizes the explicit \ state and retries one fresh-page query before failing the build\n- added focused verifier coverage for both the retryable timeout path and the retryable error-state path\n\nValidation:\n- \bun test v1.3.13 (bf2e2cec)\n- \bun run build:export [MDX] generated files in 19.798708000000033ms Route (app) ○ (Static) prerendered as static content Wrote advanced Orama search bootstrap to /Users/abdifamily/work/learn-agent-factories/.claude/worktrees/transformer-causal-attention-page/out/api/search, /Users/abdifamily/work/learn-agent-factories/.claude/worktrees/transformer-causal-attention-page/out/api/search.vi, /Users/abdifamily/work/learn-agent-factories/.claude/worktrees/transformer-causal-attention-page/out/api/search.ja. |
|
Mergeability follow-up on commit 5b136ed:
Follow-up status:
|
|
Mergeability follow-up on commit b1fa463:
Follow-up status:
|
|
Mergeability follow-up on commit 49ff90c:
Follow-up status:
|
|
Mergeability follow-up on commit 5b5c5a7:
Follow-up status:
|
|
Mergeability follow-up on commit a099c0b:
Follow-up status:
|
|
Mergeability follow-up on commit de5c42c:
Follow-up status:
|
|
Mergeability follow-up on commit 67af8c0:
Follow-up status:
|
|
Mergeability follow-up on commit 5d09fdb:
Follow-up status:
|
|
Mergeability follow-up on commit 078760a:
Follow-up status:
|
|
Mergeability follow-up on commit
Follow-up status:
|
|
Mergeability follow-up on commit
Current UTC status: required CI is attached to |
1 participant
{
"project": "Model Atlas — Transformer Causal Attention Canonical Page",
"branchName": "transformer-causal-attention-page",
"description": "Publish one canonical English
causal attentionmodule page, backed by registry data and localized messages, so readers can directly understand the no-looking-ahead masking rule behind decoder-only generation and discover the page through attention-focused search, tags, and related docs.","context": {
"customerAsk": "Add one canonical English docs page for
causal attention, including the colocatedmessages/en.json, any requiredassets.json, and the matching registry record. Classify and tag it so it is discoverable from attention-focused search and tag surfaces, and add the minimum focused validation needed for registry/message correctness plus any page-specific related-link expectations. Keep the work English-only with no locale-manifest or language-switcher changes.","problem": "The site already explains broad attention topics and some attention variants, but it does not yet publish a canonical
causal attentionpage. Readers trying to understand ChatGPT-style decoder-only models therefore have to reconstruct the no-looking-ahead masking rule from broader attention or decoder pages instead of finding a direct explainer for one of the key mechanisms behind autoregressive generation.","solution": "Create a published
module.causal-attentionregistry record and a canonical/docs/modules/causal-attentionpage with English-only localized content. Update tags, aliases, and related relationships so search, tag landing pages, and related-doc surfaces presentcausal attentionas a first-class attention variant and connect it toself-attention,decoder,token, andprefill/decode split. Add focused automated checks for the page contract, discovery behavior, and nearby related links."},
"acceptanceCriteria": [
"A published canonical docs page exists for
causal attentionwith a matching module registry record, English messages, and any required local assets.","The page follows canonical docs writing rules with one folded
openingSummary, layperson-friendly language, a clear explanation of the no-looking-ahead masking rule, and no phase/process/meta language.","Search, tags, aliases, and related-doc surfaces make
causal attentiondiscoverable from attention-focused browsing and direct queries for causal masking behavior.","The page gives readers clear, correct paths to
self-attention,decoder,token, andprefill/decode split, with registry-backed relationships that resolve to shipped pages.","Focused validation covers registry/message integrity plus page-specific related-link or discovery behavior for
causal attention.","Quality gate: make typecheck, make lint, and make test pass."
],
"userStories": [
{
"id": "transformer-causal-attention-page-001",
"title": "Register causal attention as a first-class attention variant",
"description": "As a reader searching for causal attention, I want the site to treat it as its own attention-variant page so I can find a direct answer instead of inferring it from generic attention or decoder pages.",
"acceptanceCriteria": [
"A published module registry record exists for
causal attentionwith a stable id, canonical slug, attention-family metadata, and aliases that cover representative query forms such ascausal attention,causal self-attention, andcausal masking.","Registry relationships connect
causal attentiontoattention,self-attention,decoder,token, andprefill/decode splitin ways that match a canonical attention-variant page.","The record is tagged so attention-focused search and tag landing surfaces can include it without special-case logic.",
"Typecheck passes",
"Tests pass"
],
"priority": 1,
"passes": true,
"notes": ""
},
{
"id": "transformer-causal-attention-page-002",
"title": "Publish the canonical causal attention page",
"description": "As a technical layperson learning decoder-only transformers, I want a dedicated causal attention page so I can understand the masking rule, why it matters for next-token generation, and how it relates to nearby concepts already on the site.",
"acceptanceCriteria": [
"A canonical module page exists at
/docs/modules/causal-attentionwith matching frontmatter,messages/en.json, and any required localassets.json.","The page opens with one folded
openingSummaryand explains in plain language that each token can attend only to earlier tokens and itself, not to future tokens.","The page explains why that rule matters for autoregressive generation and ties it clearly to decoder behavior, token-by-token generation, and prefill-versus-decode style reasoning.",
"The page links where genuinely helpful to
self-attention,decoder,token, andprefill/decode splitwithout turning into a benchmark or paper-download page.","Typecheck passes",
"Tests pass",
"Verify in browser using the Browser plugin"
],
"priority": 2,
"passes": true,
"notes": ""
},
{
"id": "transformer-causal-attention-page-003",
"title": "Make causal attention show up on attention discovery surfaces",
"description": "As a reader exploring attention topics, I want attention tag pages, related docs, and direct search queries to surface causal attention so I can reach the page even if I start from a nearby concept.",
"acceptanceCriteria": [
"Representative queries such as
causal attention,causal self-attention,causal mask, orlook ahead maskreturn the canonicalcausal attentionpage as a direct search result.","Attention-focused tag or browse surfaces include
causal attentionalongside other shipped attention resources in the correct kind grouping.","The
causal attentionpage renders related docs that include navigable links to shipped nearby pages forattention,self-attention,decoder,token, and at least one generation-serving concept.","Browser-visible rendering shows title, summary, tags, and related-doc links without broken links or missing-content placeholders.",
"Typecheck passes",
"Tests pass",
"Verify in browser using the Browser plugin"
],
"priority": 3,
"passes": true,
"notes": ""
},
{
"id": "transformer-causal-attention-page-004",
"title": "Add focused validation for the page contract and nearby links",
"description": "As a maintainer, I want targeted automated proof for the causal attention slice so registry, message, discovery, and related-link regressions are caught without adding unrelated test churn.",
"acceptanceCriteria": [
"Validation or tests confirm the
causal attentionpage route, registry record, and default English messages resolve together.","Coverage asserts at least one page-specific discovery outcome and at least one page-specific related-link expectation for
causal attention.","Coverage remains focused on observable behavior for this page slice and does not introduce inventory-style or meta-test requirements unrelated to the shipped behavior.",
"Typecheck passes",
"Tests pass"
],
"priority": 4,
"passes": true,
"notes": ""
}
]
}