{"schemaVersion":1,"id":"https://lucioduran.com/decisions","url":"https://lucioduran.com/decisions","title":"Architecture Decision Records","description":"Formal records of significant architectural decisions made in the design and implementation of lucioduran.com, documenting context, rationale, and trade-offs.","language":"en","datePublished":null,"dateModified":null,"contentFormat":"text/markdown","content":"# Architecture Decision Records\n\nFormal records documenting the context, rationale, and trade-offs behind every significant technical decision in this system.\n\n## Decision Log\n\n20 recorded decisions\n\n- [ADR-001accepted\n\n  ### Static Site Generation over Server-Side Rendering\n\n  The portfolio site serves content that changes infrequently, work experience, education records, technology stack, and biographical data. The API backing these ...\n\n  April 12, 2024](<https://lucioduran.com/decisions/ssg-over-ssr>)\n- [ADR-002accepted\n\n  ### MongoDB over PostgreSQL for Content API\n\n  The portfolio's content model is inherently heterogeneous. Work experiences carry arrays of technologies, nested duty descriptions, and optional media reference...\n\n  February 8, 2024](<https://lucioduran.com/decisions/mongodb-over-postgresql>)\n- [ADR-003accepted\n\n  ### styled-components over Tailwind CSS\n\n  The portfolio requires a theming system that supports runtime switching between dark and light modes without page reload. The design language demands precise co...\n\n  May 3, 2024](<https://lucioduran.com/decisions/styled-components-over-tailwind>)\n- [ADR-004accepted\n\n  ### Single Accent Color System over Category-Based Palette\n\n  The original design assigned unique neon colors to each technology category and content type, 12 distinct hues mapped to categories like Frontend, Backend, DevO...\n\n  December 20, 2025](<https://lucioduran.com/decisions/single-accent-color-system>)\n- [ADR-005accepted\n\n  ### Decoupled API Architecture\n\n  The portfolio's data layer could be co-located with the Next.js frontend using API routes (pages/api/\\*), which would simplify deployment to a single Vercel proj...\n\n  January 15, 2024](<https://lucioduran.com/decisions/decoupled-api-architecture>)\n- [ADR-006accepted\n\n  ### AI agent readability as First-Class Concern\n\n  The portfolio exists in an era where content is consumed not only by humans via browsers but increasingly by AI agents, LLMs, and automated systems that parse w...\n\n  February 10, 2026](<https://lucioduran.com/decisions/agent-experience-first-class>)\n- [ADR-007accepted\n\n  ### CSS Grid over Flexbox for Layout System\n\n  The original layout system used Flexbox with calc()-based percentage widths for multi-column arrangements. Technology grids used \\`flex-wrap: wrap\\` with \\`width: ...\n\n  December 22, 2025](<https://lucioduran.com/decisions/css-grid-over-flexbox>)\n- [ADR-008accepted\n\n  ### Static JSON over CMS for Decision Records\n\n  Architecture Decision Records are a new content type being added to the portfolio. The existing content model uses a MongoDB-backed API for all data. Adding ADR...\n\n  February 15, 2026](<https://lucioduran.com/decisions/static-json-over-cms>)\n- [ADR-009accepted\n\n  ### Geist Font Family as Design System Foundation\n\n  Typography selection for a portfolio site is a high-leverage decision that affects perceived quality across every page. The previous font stack used system font...\n\n  November 28, 2025](<https://lucioduran.com/decisions/geist-font-system>)\n- [ADR-010accepted\n\n  ### ISR-Ready Architecture with Full Static Fallback\n\n  Incremental Static Regeneration (ISR) is a Next.js feature that allows static pages to be revalidated after deployment without a full rebuild. For a portfolio w...\n\n  June 18, 2024](<https://lucioduran.com/decisions/isr-ready-architecture>)\n- [ADR-011accepted\n\n  ### Multi-Layer Structured Data Strategy for Semantic Discoverability\n\n  The portfolio's AI agent readability layer established the principle of treating AI agents as first-class consumers (ADR-006). But the implementation of that pr...\n\n  February 11, 2026](<https://lucioduran.com/decisions/multi-layer-structured-data>)\n- [ADR-012accepted\n\n  ### Deliberate AI Crawler Access Policy over Default Blocking\n\n  The default posture for most websites toward AI crawlers is either passive (no explicit policy, relying on robots.txt default Allow) or hostile (blocking GPTBot...\n\n  February 12, 2026](<https://lucioduran.com/decisions/deliberate-ai-crawler-access-policy>)\n- [ADR-013accepted\n\n  ### Zero-Downtime Deploy Strategy with Atomic Rollouts\n\n  The portfolio site and its API are deployed independently (ADR-005) with different deployment mechanisms. The frontend deploys to Vercel via git push, which tri...\n\n  March 10, 2024](<https://lucioduran.com/decisions/zero-downtime-deploy-strategy>)\n- [ADR-014accepted\n\n  ### Defensive Data Fetching with Graceful Degradation\n\n  The portfolio's SSG build process (ADR-001) fetches data from the API (api.lucioduran.com) during build time. If the API is unavailable, slow, or returns malfor...\n\n  April 28, 2024](<https://lucioduran.com/decisions/defensive-data-fetching>)\n- [ADR-015accepted\n\n  ### Critical Rendering Path Optimization Strategy\n\n  The portfolio's target audience, technical hiring managers and VPs of Engineering, often evaluate sites on mobile devices during commutes or between meetings, o...\n\n  July 15, 2024](<https://lucioduran.com/decisions/critical-rendering-path-optimization>)\n- [ADR-016accepted\n\n  ### Scoped Remote Image Patterns over Generic CDN Proxy\n\n  The portfolio displays images from multiple origins: profile photos and social cards from statics.lucioduran.com, dynamic content images from api.lucioduran.com...\n\n  May 20, 2024](<https://lucioduran.com/decisions/scoped-remote-image-patterns>)\n- [ADR-017accepted\n\n  ### Defense-in-Depth HTTP Security Headers\n\n  HTTP security headers are the first layer of defense against common web attacks: XSS (Cross-Site Scripting), clickjacking, MIME-type sniffing, and information l...\n\n  March 25, 2024](<https://lucioduran.com/decisions/defense-in-depth-security-headers>)\n- [ADR-018accepted\n\n  ### Monolithic Page Components over Micro-Component Architecture\n\n  The portfolio's component architecture faces a fundamental trade-off: should pages be built from small, reusable atomic components (buttons, cards, badges, labe...\n\n  June 2, 2024](<https://lucioduran.com/decisions/monolithic-page-components>)\n- [ADR-019accepted\n\n  ### Semantic URL Routing with Explicit Path Mapping\n\n  Next.js Pages Router uses file-system-based routing: pages/technologies/\\[id\\].js creates routes at /technologies/:id. The portfolio has three dynamic route types...\n\n  May 15, 2024](<https://lucioduran.com/decisions/semantic-url-routing>)\n- [ADR-020accepted\n\n  ### Calibrated Uncertainty as Architectural Metadata\n\n  Architecture Decision Records traditionally document three things: the context (why a decision was needed), the decision (what was chosen), and the consequences...\n\n  February 16, 2026](<https://lucioduran.com/decisions/calibrated-uncertainty-metadata>)","headings":[{"level":1,"text":"Architecture Decision Records","url":"https://lucioduran.com/decisions#title"},{"level":2,"text":"Decision Log","url":"https://lucioduran.com/decisions#decisions-log"},{"level":3,"text":"Static Site Generation over Server-Side Rendering","url":"https://lucioduran.com/decisions#decision-ssg-over-ssr"},{"level":3,"text":"MongoDB over PostgreSQL for Content API","url":"https://lucioduran.com/decisions#decision-mongodb-over-postgresql"},{"level":3,"text":"styled-components over Tailwind CSS","url":"https://lucioduran.com/decisions#decision-styled-components-over-tailwind"},{"level":3,"text":"Single Accent Color System over Category-Based Palette","url":"https://lucioduran.com/decisions#decision-single-accent-color-system"},{"level":3,"text":"Decoupled API Architecture","url":"https://lucioduran.com/decisions#decision-decoupled-api-architecture"},{"level":3,"text":"AI agent readability as First-Class Concern","url":"https://lucioduran.com/decisions#decision-agent-experience-first-class"},{"level":3,"text":"CSS Grid over Flexbox for Layout System","url":"https://lucioduran.com/decisions#decision-css-grid-over-flexbox"},{"level":3,"text":"Static JSON over CMS for Decision Records","url":"https://lucioduran.com/decisions#decision-static-json-over-cms"},{"level":3,"text":"Geist Font Family as Design System Foundation","url":"https://lucioduran.com/decisions#decision-geist-font-system"},{"level":3,"text":"ISR-Ready Architecture with Full Static Fallback","url":"https://lucioduran.com/decisions#decision-isr-ready-architecture"},{"level":3,"text":"Multi-Layer Structured Data Strategy for Semantic Discoverability","url":"https://lucioduran.com/decisions#decision-multi-layer-structured-data"},{"level":3,"text":"Deliberate AI Crawler Access Policy over Default Blocking","url":"https://lucioduran.com/decisions#decision-deliberate-ai-crawler-access-policy"},{"level":3,"text":"Zero-Downtime Deploy Strategy with Atomic Rollouts","url":"https://lucioduran.com/decisions#decision-zero-downtime-deploy-strategy"},{"level":3,"text":"Defensive Data Fetching with Graceful Degradation","url":"https://lucioduran.com/decisions#decision-defensive-data-fetching"},{"level":3,"text":"Critical Rendering Path Optimization Strategy","url":"https://lucioduran.com/decisions#decision-critical-rendering-path-optimization"},{"level":3,"text":"Scoped Remote Image Patterns over Generic CDN Proxy","url":"https://lucioduran.com/decisions#decision-scoped-remote-image-patterns"},{"level":3,"text":"Defense-in-Depth HTTP Security Headers","url":"https://lucioduran.com/decisions#decision-defense-in-depth-security-headers"},{"level":3,"text":"Monolithic Page Components over Micro-Component Architecture","url":"https://lucioduran.com/decisions#decision-monolithic-page-components"},{"level":3,"text":"Semantic URL Routing with Explicit Path Mapping","url":"https://lucioduran.com/decisions#decision-semantic-url-routing"},{"level":3,"text":"Calibrated Uncertainty as Architectural Metadata","url":"https://lucioduran.com/decisions#decision-calibrated-uncertainty-metadata"}],"sections":[{"heading":"Architecture Decision Records","level":1,"url":"https://lucioduran.com/decisions","content":""},{"heading":"Architecture Decision Records","level":1,"url":"https://lucioduran.com/decisions#title","content":"Formal records documenting the context, rationale, and trade-offs behind every significant technical decision in this system."},{"heading":"Decision Log","level":2,"url":"https://lucioduran.com/decisions#decisions-log","content":"20 recorded decisions\n\nADR-001accepted"},{"heading":"Static Site Generation over Server-Side Rendering","level":3,"url":"https://lucioduran.com/decisions#decision-ssg-over-ssr","content":"The portfolio site serves content that changes infrequently, work experience, education records, technology stack, and biographical data. The API backing these ...\n\nApril 12, 2024\n\nADR-002accepted"},{"heading":"MongoDB over PostgreSQL for Content API","level":3,"url":"https://lucioduran.com/decisions#decision-mongodb-over-postgresql","content":"The portfolio's content model is inherently heterogeneous. Work experiences carry arrays of technologies, nested duty descriptions, and optional media reference...\n\nFebruary 8, 2024\n\nADR-003accepted"},{"heading":"styled-components over Tailwind CSS","level":3,"url":"https://lucioduran.com/decisions#decision-styled-components-over-tailwind","content":"The portfolio requires a theming system that supports runtime switching between dark and light modes without page reload. The design language demands precise co...\n\nMay 3, 2024\n\nADR-004accepted"},{"heading":"Single Accent Color System over Category-Based Palette","level":3,"url":"https://lucioduran.com/decisions#decision-single-accent-color-system","content":"The original design assigned unique neon colors to each technology category and content type, 12 distinct hues mapped to categories like Frontend, Backend, DevO...\n\nDecember 20, 2025\n\nADR-005accepted"},{"heading":"Decoupled API Architecture","level":3,"url":"https://lucioduran.com/decisions#decision-decoupled-api-architecture","content":"The portfolio's data layer could be co-located with the Next.js frontend using API routes (pages/api/\\*), which would simplify deployment to a single Vercel proj...\n\nJanuary 15, 2024\n\nADR-006accepted"},{"heading":"AI agent readability as First-Class Concern","level":3,"url":"https://lucioduran.com/decisions#decision-agent-experience-first-class","content":"The portfolio exists in an era where content is consumed not only by humans via browsers but increasingly by AI agents, LLMs, and automated systems that parse w...\n\nFebruary 10, 2026\n\nADR-007accepted"},{"heading":"CSS Grid over Flexbox for Layout System","level":3,"url":"https://lucioduran.com/decisions#decision-css-grid-over-flexbox","content":"The original layout system used Flexbox with calc()-based percentage widths for multi-column arrangements. Technology grids used \\`flex-wrap: wrap\\` with \\`width: ...\n\nDecember 22, 2025\n\nADR-008accepted"},{"heading":"Static JSON over CMS for Decision Records","level":3,"url":"https://lucioduran.com/decisions#decision-static-json-over-cms","content":"Architecture Decision Records are a new content type being added to the portfolio. The existing content model uses a MongoDB-backed API for all data. Adding ADR...\n\nFebruary 15, 2026\n\nADR-009accepted"},{"heading":"Geist Font Family as Design System Foundation","level":3,"url":"https://lucioduran.com/decisions#decision-geist-font-system","content":"Typography selection for a portfolio site is a high-leverage decision that affects perceived quality across every page. The previous font stack used system font...\n\nNovember 28, 2025\n\nADR-010accepted"},{"heading":"ISR-Ready Architecture with Full Static Fallback","level":3,"url":"https://lucioduran.com/decisions#decision-isr-ready-architecture","content":"Incremental Static Regeneration (ISR) is a Next.js feature that allows static pages to be revalidated after deployment without a full rebuild. For a portfolio w...\n\nJune 18, 2024\n\nADR-011accepted"},{"heading":"Multi-Layer Structured Data Strategy for Semantic Discoverability","level":3,"url":"https://lucioduran.com/decisions#decision-multi-layer-structured-data","content":"The portfolio's AI agent readability layer established the principle of treating AI agents as first-class consumers (ADR-006). But the implementation of that pr...\n\nFebruary 11, 2026\n\nADR-012accepted"},{"heading":"Deliberate AI Crawler Access Policy over Default Blocking","level":3,"url":"https://lucioduran.com/decisions#decision-deliberate-ai-crawler-access-policy","content":"The default posture for most websites toward AI crawlers is either passive (no explicit policy, relying on robots.txt default Allow) or hostile (blocking GPTBot...\n\nFebruary 12, 2026\n\nADR-013accepted"},{"heading":"Zero-Downtime Deploy Strategy with Atomic Rollouts","level":3,"url":"https://lucioduran.com/decisions#decision-zero-downtime-deploy-strategy","content":"The portfolio site and its API are deployed independently (ADR-005) with different deployment mechanisms. The frontend deploys to Vercel via git push, which tri...\n\nMarch 10, 2024\n\nADR-014accepted"},{"heading":"Defensive Data Fetching with Graceful Degradation","level":3,"url":"https://lucioduran.com/decisions#decision-defensive-data-fetching","content":"The portfolio's SSG build process (ADR-001) fetches data from the API (api.lucioduran.com) during build time. If the API is unavailable, slow, or returns malfor...\n\nApril 28, 2024\n\nADR-015accepted"},{"heading":"Critical Rendering Path Optimization Strategy","level":3,"url":"https://lucioduran.com/decisions#decision-critical-rendering-path-optimization","content":"The portfolio's target audience, technical hiring managers and VPs of Engineering, often evaluate sites on mobile devices during commutes or between meetings, o...\n\nJuly 15, 2024\n\nADR-016accepted"},{"heading":"Scoped Remote Image Patterns over Generic CDN Proxy","level":3,"url":"https://lucioduran.com/decisions#decision-scoped-remote-image-patterns","content":"The portfolio displays images from multiple origins: profile photos and social cards from statics.lucioduran.com, dynamic content images from api.lucioduran.com...\n\nMay 20, 2024\n\nADR-017accepted"},{"heading":"Defense-in-Depth HTTP Security Headers","level":3,"url":"https://lucioduran.com/decisions#decision-defense-in-depth-security-headers","content":"HTTP security headers are the first layer of defense against common web attacks: XSS (Cross-Site Scripting), clickjacking, MIME-type sniffing, and information l...\n\nMarch 25, 2024\n\nADR-018accepted"},{"heading":"Monolithic Page Components over Micro-Component Architecture","level":3,"url":"https://lucioduran.com/decisions#decision-monolithic-page-components","content":"The portfolio's component architecture faces a fundamental trade-off: should pages be built from small, reusable atomic components (buttons, cards, badges, labe...\n\nJune 2, 2024\n\nADR-019accepted"},{"heading":"Semantic URL Routing with Explicit Path Mapping","level":3,"url":"https://lucioduran.com/decisions#decision-semantic-url-routing","content":"Next.js Pages Router uses file-system-based routing: pages/technologies/\\[id\\].js creates routes at /technologies/:id. The portfolio has three dynamic route types...\n\nMay 15, 2024\n\nADR-020accepted"},{"heading":"Calibrated Uncertainty as Architectural Metadata","level":3,"url":"https://lucioduran.com/decisions#decision-calibrated-uncertainty-metadata","content":"Architecture Decision Records traditionally document three things: the context (why a decision was needed), the decision (what was chosen), and the consequences...\n\nFebruary 16, 2026"}],"links":[{"text":"ADR-001acceptedStatic Site Generation over Server-Side RenderingThe portfolio site serves content that changes infrequently, work experience, education records, technology stack, and biographical data. The API backing these ...April 12, 2024","url":"https://lucioduran.com/decisions/ssg-over-ssr"},{"text":"ADR-002acceptedMongoDB over PostgreSQL for Content APIThe portfolio's content model is inherently heterogeneous. Work experiences carry arrays of technologies, nested duty descriptions, and optional media reference...February 8, 2024","url":"https://lucioduran.com/decisions/mongodb-over-postgresql"},{"text":"ADR-003acceptedstyled-components over Tailwind CSSThe portfolio requires a theming system that supports runtime switching between dark and light modes without page reload. The design language demands precise co...May 3, 2024","url":"https://lucioduran.com/decisions/styled-components-over-tailwind"},{"text":"ADR-004acceptedSingle Accent Color System over Category-Based PaletteThe original design assigned unique neon colors to each technology category and content type, 12 distinct hues mapped to categories like Frontend, Backend, DevO...December 20, 2025","url":"https://lucioduran.com/decisions/single-accent-color-system"},{"text":"ADR-005acceptedDecoupled API ArchitectureThe portfolio's data layer could be co-located with the Next.js frontend using API routes (pages/api/*), which would simplify deployment to a single Vercel proj...January 15, 2024","url":"https://lucioduran.com/decisions/decoupled-api-architecture"},{"text":"ADR-006acceptedAI agent readability as First-Class ConcernThe portfolio exists in an era where content is consumed not only by humans via browsers but increasingly by AI agents, LLMs, and automated systems that parse w...February 10, 2026","url":"https://lucioduran.com/decisions/agent-experience-first-class"},{"text":"ADR-007acceptedCSS Grid over Flexbox for Layout SystemThe original layout system used Flexbox with calc()-based percentage widths for multi-column arrangements. Technology grids used `flex-wrap: wrap` with `width: ...December 22, 2025","url":"https://lucioduran.com/decisions/css-grid-over-flexbox"},{"text":"ADR-008acceptedStatic JSON over CMS for Decision RecordsArchitecture Decision Records are a new content type being added to the portfolio. The existing content model uses a MongoDB-backed API for all data. Adding ADR...February 15, 2026","url":"https://lucioduran.com/decisions/static-json-over-cms"},{"text":"ADR-009acceptedGeist Font Family as Design System FoundationTypography selection for a portfolio site is a high-leverage decision that affects perceived quality across every page. The previous font stack used system font...November 28, 2025","url":"https://lucioduran.com/decisions/geist-font-system"},{"text":"ADR-010acceptedISR-Ready Architecture with Full Static FallbackIncremental Static Regeneration (ISR) is a Next.js feature that allows static pages to be revalidated after deployment without a full rebuild. For a portfolio w...June 18, 2024","url":"https://lucioduran.com/decisions/isr-ready-architecture"},{"text":"ADR-011acceptedMulti-Layer Structured Data Strategy for Semantic DiscoverabilityThe portfolio's AI agent readability layer established the principle of treating AI agents as first-class consumers (ADR-006). But the implementation of that pr...February 11, 2026","url":"https://lucioduran.com/decisions/multi-layer-structured-data"},{"text":"ADR-012acceptedDeliberate AI Crawler Access Policy over Default BlockingThe default posture for most websites toward AI crawlers is either passive (no explicit policy, relying on robots.txt default Allow) or hostile (blocking GPTBot...February 12, 2026","url":"https://lucioduran.com/decisions/deliberate-ai-crawler-access-policy"},{"text":"ADR-013acceptedZero-Downtime Deploy Strategy with Atomic RolloutsThe portfolio site and its API are deployed independently (ADR-005) with different deployment mechanisms. The frontend deploys to Vercel via git push, which tri...March 10, 2024","url":"https://lucioduran.com/decisions/zero-downtime-deploy-strategy"},{"text":"ADR-014acceptedDefensive Data Fetching with Graceful DegradationThe portfolio's SSG build process (ADR-001) fetches data from the API (api.lucioduran.com) during build time. If the API is unavailable, slow, or returns malfor...April 28, 2024","url":"https://lucioduran.com/decisions/defensive-data-fetching"},{"text":"ADR-015acceptedCritical Rendering Path Optimization StrategyThe portfolio's target audience, technical hiring managers and VPs of Engineering, often evaluate sites on mobile devices during commutes or between meetings, o...July 15, 2024","url":"https://lucioduran.com/decisions/critical-rendering-path-optimization"},{"text":"ADR-016acceptedScoped Remote Image Patterns over Generic CDN ProxyThe portfolio displays images from multiple origins: profile photos and social cards from statics.lucioduran.com, dynamic content images from api.lucioduran.com...May 20, 2024","url":"https://lucioduran.com/decisions/scoped-remote-image-patterns"},{"text":"ADR-017acceptedDefense-in-Depth HTTP Security HeadersHTTP security headers are the first layer of defense against common web attacks: XSS (Cross-Site Scripting), clickjacking, MIME-type sniffing, and information l...March 25, 2024","url":"https://lucioduran.com/decisions/defense-in-depth-security-headers"},{"text":"ADR-018acceptedMonolithic Page Components over Micro-Component ArchitectureThe portfolio's component architecture faces a fundamental trade-off: should pages be built from small, reusable atomic components (buttons, cards, badges, labe...June 2, 2024","url":"https://lucioduran.com/decisions/monolithic-page-components"},{"text":"ADR-019acceptedSemantic URL Routing with Explicit Path MappingNext.js Pages Router uses file-system-based routing: pages/technologies/[id].js creates routes at /technologies/:id. The portfolio has three dynamic route types...May 15, 2024","url":"https://lucioduran.com/decisions/semantic-url-routing"},{"text":"ADR-020acceptedCalibrated Uncertainty as Architectural MetadataArchitecture Decision Records traditionally document three things: the context (why a decision was needed), the decision (what was chosen), and the consequences...February 16, 2026","url":"https://lucioduran.com/decisions/calibrated-uncertainty-metadata"}],"structuredData":[{"@context":"https://schema.org","@graph":[{"@type":"Person","@id":"https://lucioduran.com/#person","name":"Lucio Durán","url":"https://lucioduran.com/"},{"@type":"WebSite","@id":"https://lucioduran.com/#website","url":"https://lucioduran.com/","name":"Lucio Durán","inLanguage":["en","es"],"publisher":{"@id":"https://lucioduran.com/#person"}},{"@type":"CollectionPage","@id":"https://lucioduran.com/decisions#page","url":"https://lucioduran.com/decisions","name":"Architecture Decision Records | Lucio Durán","description":"Formal records of significant architectural decisions made in the design and implementation of lucioduran.com, documenting context, rationale, and trade-offs.","inLanguage":"en","author":{"@id":"https://lucioduran.com/#person"},"publisher":{"@id":"https://lucioduran.com/#person"},"isPartOf":{"@id":"https://lucioduran.com/#website"},"isAccessibleForFree":true,"mainEntity":{"@id":"https://lucioduran.com/decisions#list"},"about":{"@id":"https://lucioduran.com/#person"},"breadcrumb":{"@id":"https://lucioduran.com/decisions#breadcrumb"}},{"@type":"ItemList","itemListElement":[{"@type":"ListItem","position":1,"name":"ADR-001: Static Site Generation over Server-Side Rendering","url":"https://lucioduran.com/decisions/ssg-over-ssr"},{"@type":"ListItem","position":2,"name":"ADR-002: MongoDB over PostgreSQL for Content API","url":"https://lucioduran.com/decisions/mongodb-over-postgresql"},{"@type":"ListItem","position":3,"name":"ADR-003: styled-components over Tailwind CSS","url":"https://lucioduran.com/decisions/styled-components-over-tailwind"},{"@type":"ListItem","position":4,"name":"ADR-004: Single Accent Color System over Category-Based Palette","url":"https://lucioduran.com/decisions/single-accent-color-system"},{"@type":"ListItem","position":5,"name":"ADR-005: Decoupled API Architecture","url":"https://lucioduran.com/decisions/decoupled-api-architecture"},{"@type":"ListItem","position":6,"name":"ADR-006: AI agent readability as First-Class Concern","url":"https://lucioduran.com/decisions/agent-experience-first-class"},{"@type":"ListItem","position":7,"name":"ADR-007: CSS Grid over Flexbox for Layout System","url":"https://lucioduran.com/decisions/css-grid-over-flexbox"},{"@type":"ListItem","position":8,"name":"ADR-008: Static JSON over CMS for Decision Records","url":"https://lucioduran.com/decisions/static-json-over-cms"},{"@type":"ListItem","position":9,"name":"ADR-009: Geist Font Family as Design System Foundation","url":"https://lucioduran.com/decisions/geist-font-system"},{"@type":"ListItem","position":10,"name":"ADR-010: ISR-Ready Architecture with Full Static Fallback","url":"https://lucioduran.com/decisions/isr-ready-architecture"},{"@type":"ListItem","position":11,"name":"ADR-011: Multi-Layer Structured Data Strategy for Semantic Discoverability","url":"https://lucioduran.com/decisions/multi-layer-structured-data"},{"@type":"ListItem","position":12,"name":"ADR-012: Deliberate AI Crawler Access Policy over Default Blocking","url":"https://lucioduran.com/decisions/deliberate-ai-crawler-access-policy"},{"@type":"ListItem","position":13,"name":"ADR-013: Zero-Downtime Deploy Strategy with Atomic Rollouts","url":"https://lucioduran.com/decisions/zero-downtime-deploy-strategy"},{"@type":"ListItem","position":14,"name":"ADR-014: Defensive Data Fetching with Graceful Degradation","url":"https://lucioduran.com/decisions/defensive-data-fetching"},{"@type":"ListItem","position":15,"name":"ADR-015: Critical Rendering Path Optimization Strategy","url":"https://lucioduran.com/decisions/critical-rendering-path-optimization"},{"@type":"ListItem","position":16,"name":"ADR-016: Scoped Remote Image Patterns over Generic CDN Proxy","url":"https://lucioduran.com/decisions/scoped-remote-image-patterns"},{"@type":"ListItem","position":17,"name":"ADR-017: Defense-in-Depth HTTP Security Headers","url":"https://lucioduran.com/decisions/defense-in-depth-security-headers"},{"@type":"ListItem","position":18,"name":"ADR-018: Monolithic Page Components over Micro-Component Architecture","url":"https://lucioduran.com/decisions/monolithic-page-components"},{"@type":"ListItem","position":19,"name":"ADR-019: Semantic URL Routing with Explicit Path Mapping","url":"https://lucioduran.com/decisions/semantic-url-routing"},{"@type":"ListItem","position":20,"name":"ADR-020: Calibrated Uncertainty as Architectural Metadata","url":"https://lucioduran.com/decisions/calibrated-uncertainty-metadata"}],"@id":"https://lucioduran.com/decisions#list"},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://lucioduran.com/"},{"@type":"ListItem","position":2,"name":"Architecture Decisions","item":"https://lucioduran.com/decisions"}],"@id":"https://lucioduran.com/decisions#breadcrumb"}]}],"contentHash":"70b055c19548271fb2af34aaf400606fc851bd98d5a44645657cfedb054d10be","provenance":{"method":"Deterministic serialization of the server-rendered main element","source":"https://lucioduran.com/decisions","hashAlgorithm":"sha256","hashScope":"JSON document fields before contentHash and provenance","sourceHTMLBytes":170044,"contentBytes":6665}}
