Construido en público.

Cada cambio importante en Wombat empieza con una Request for Comments o un Architecture Decision Record público. Esta página sigue cada decisión, desde el primer borrador hasta el merge, para que nada quede oculto.

38
Decisiones totales
35
RFCs
19
Abiertas a revisión
14
Implementadas
3
ADRs
3
ADR aceptados

Todas las Requests for Comments.

Filtra por proyecto y estado, lee los resúmenes y sigue las discusiones y pull requests enlazados.

Framework

RFCRFC-0001 Initial 7-pillar framework structure
implementedframeworkpillarsframework

Establishes the core seven-pillar model as the foundational structure of Wombat. Extended to eight pillars by RFC-0012.

Author: sascha-lewandowski Opened: 2025-12-05Decided: 2025-12-05Implemented: 2025-12-05Discussion: GitHub →PR: #1
RFCRFC-0002 Public 2026 roadmap and milestone planning
implementedgovernanceroadmapgovernance

Defines the public roadmap for 2026 covering Q1–Q4 milestones, v1.0 target, pilot programme, and foundation readiness goals.

Author: sascha-lewandowski Opened: 2025-12-06Decided: 2025-12-06Implemented: 2025-12-06Discussion: GitHub →PR: #2
RFCRFC-0003 Pillar descriptions and key questions — 7 pillars
implementedframeworkpillarsframework

Adds the initial content definition for each of the 7 pillars. Later extended to cover the 8th Agentic pillar (RFC-0012).

Author: sascha-lewandowski Opened: 2025-12-07Decided: 2025-12-07Implemented: 2025-12-07Discussion: GitHub →PR: #3
RFCRFC-0004 Documentation migration to AsciiDoc / Antora
implementeddocsdocsantoraasciidoc

Migrates all framework documentation from Markdown to AsciiDoc and establishes Antora as the documentation build system with component versioning.

Author: t1murl Opened: 2026-02-20Decided: 2026-02-26Implemented: 2026-02-26Discussion: GitHub →PR: #4
RFCRFC-0005 Contribution metadata — CONTRIBUTING, CODE_OF_CONDUCT, SECURITY
implementedgovernancegovernanceoss-health

Adds the standard open-source health files to the framework repository.

Author: sascha-lewandowski Opened: 2026-02-06Decided: 2026-02-08Implemented: 2026-02-08Discussion: GitHub →PR: #6
RFCRFC-0006 Sovereign pillar (Pillar 7) — initial controls
implementedframeworkpillarssovereigncontrols

Introduces the Sovereign pillar as the 7th pillar of Wombat with 10 initial controls (WAF-SOV-010 through WAF-SOV-100).

Author: sascha-lewandowski Opened: 2026-02-14Decided: 2026-03-04Implemented: 2026-03-04Discussion: GitHub →
RFCRFC-0007 Governance refactor — modular best practices, case studies and navigation
implementedframeworkpillarsgovernancedocs

Restructures the Governance pillar into modular best-practice pages and adds case-study content.

Author: sascha-lewandowski Opened: 2026-02-24Decided: 2026-03-04Implemented: 2026-03-04Discussion: GitHub →PR: #10
RFCRFC-0008 Controls schema v1 — machine-readable YAML specification
implementedtoolingcontrolsschematooling

Defines a formal schema for Wombat controls YAML files, enabling validation and tooling integration for the 83+ controls library.

Author: sascha-lewandowski Opened: 2026-03-10Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0009 PASS scoring model — formal specification for v1.0
implementedframeworkscoringpassframework

Formalises the PASS scoring model as a normative specification for tier definitions, calculation rules, aggregation logic, and versioning contract.

Author: t1murl Opened: 2026-03-08Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0010 Assessment tooling — CLI and scorecard approach
implementedtoolingtoolingpassclidashboard

Defines the approach for official Wombat assessment tooling including the WOMBATpass CLI, server, dashboard, and web scorecard.

Author: sascha-lewandowski Opened: 2026-03-11Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0011 CI/CD pipeline for framework and tooling repositories
implementedtoolingcitoolingautomation

Introduces automated checks and release workflows for framework, wafpass-core, wafpass-server, and wafpass-dashboard repositories.

Author: t1murl Opened: 2026-03-11Decided: 2026-03-22Implemented: 2026-03-22Discussion: GitHub →
RFCRFC-0012 Agentic pillar as the 8th pillar
implementedframeworkpillarsagenticcontrols

Adds the Agentic pillar as the 8th pillar of Wombat with 10 initial controls, regulatory mappings, and bilingual documentation.

Author: sascha-lewandowski Opened: 2026-07-01Decided: 2026-07-05Implemented: 2026-07-05Discussion: GitHub →PR: #19
RFCRFC-0016 Control-level remediation playbooks
draftframeworkcontrolsremediationframework

Standardises machine- and human-readable remediation guidance for every Wombat control so operators can act on findings directly.

Author: sascha-lewandowski Opened: 2026-07-08Discussion: GitHub →
RFCRFC-0017 Multi-cloud provider expansion beyond AWS and SINA Cloud
drafttoolingtoolingcloud-providersawsazuregcp

Defines how WOMBATpass detection and controls will be extended to cover Azure, GCP, and other cloud providers while keeping the framework cloud-agnostic.

Author: sascha-lewandowski Opened: 2026-07-08Discussion: GitHub →
RFCRFC-GH-framework-26 RFC: Quality Assurance
opendocsdocscilinting

CI checks for dead xrefs, unregistered nav.adoc files, and control-schema consistency between YAML, AsciiDoc, and navigation.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #26
RFCRFC-GH-framework-25 RFC: Expand Sovereign & Resources
opendocsdocssovereignresources

Expand Sovereign definitions, evidence matrix, and create real overview/glossary pages for resources and wording.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #25
RFCRFC-GH-framework-23 RFC: Complete the Agentic Pillar
opendocsdocsagenticpillars

Complete Agentic pillar maturity, evidence, glossary, and best-practice pages with examples.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #23
RFCRFC-GH-framework-22 RFC: Consolidate Navigation & Links
opendocsdocsnavigationlinks

Standardise module links, convert relative xrefs to module-prefixed xrefs, and clean Markdown links.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #22
RFCRFC-GH-framework-21 RFC: Finalize Antora Structure
opendocsdocsantorastructure

Finalise antora.yml registration, create pillar-security nav, update README/AGENTS for 8-module layout.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #21
RFCRFC-GH-framework-24 RFC: Correct and Expand the Controls Catalog
opendocsdocscontrolscatalog

Align controls to 8 pillars, add Agentic, and extend control-schema.adoc.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #24

Framework · Abiertas a revisión

RFCRFC-GH-framework-26 RFC: Quality Assurance
opendocsdocscilinting

CI checks for dead xrefs, unregistered nav.adoc files, and control-schema consistency between YAML, AsciiDoc, and navigation.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #26
RFCRFC-GH-framework-25 RFC: Expand Sovereign & Resources
opendocsdocssovereignresources

Expand Sovereign definitions, evidence matrix, and create real overview/glossary pages for resources and wording.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #25
RFCRFC-GH-framework-23 RFC: Complete the Agentic Pillar
opendocsdocsagenticpillars

Complete Agentic pillar maturity, evidence, glossary, and best-practice pages with examples.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #23
RFCRFC-GH-framework-22 RFC: Consolidate Navigation & Links
opendocsdocsnavigationlinks

Standardise module links, convert relative xrefs to module-prefixed xrefs, and clean Markdown links.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #22
RFCRFC-GH-framework-21 RFC: Finalize Antora Structure
opendocsdocsantorastructure

Finalise antora.yml registration, create pillar-security nav, update README/AGENTS for 8-module layout.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #21
RFCRFC-GH-framework-24 RFC: Correct and Expand the Controls Catalog
opendocsdocscontrolscatalog

Align controls to 8 pillars, add Agentic, and extend control-schema.adoc.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #24

Framework · Borradores

RFCRFC-0016 Control-level remediation playbooks
draftframeworkcontrolsremediationframework

Standardises machine- and human-readable remediation guidance for every Wombat control so operators can act on findings directly.

Author: sascha-lewandowski Opened: 2026-07-08Discussion: GitHub →
RFCRFC-0017 Multi-cloud provider expansion beyond AWS and SINA Cloud
drafttoolingtoolingcloud-providersawsazuregcp

Defines how WOMBATpass detection and controls will be extended to cover Azure, GCP, and other cloud providers while keeping the framework cloud-agnostic.

Author: sascha-lewandowski Opened: 2026-07-08Discussion: GitHub →

Framework · Decididas / implementadas

RFCRFC-0001 Initial 7-pillar framework structure
implementedframeworkpillarsframework

Establishes the core seven-pillar model as the foundational structure of Wombat. Extended to eight pillars by RFC-0012.

Author: sascha-lewandowski Opened: 2025-12-05Decided: 2025-12-05Implemented: 2025-12-05Discussion: GitHub →PR: #1
RFCRFC-0002 Public 2026 roadmap and milestone planning
implementedgovernanceroadmapgovernance

Defines the public roadmap for 2026 covering Q1–Q4 milestones, v1.0 target, pilot programme, and foundation readiness goals.

Author: sascha-lewandowski Opened: 2025-12-06Decided: 2025-12-06Implemented: 2025-12-06Discussion: GitHub →PR: #2
RFCRFC-0003 Pillar descriptions and key questions — 7 pillars
implementedframeworkpillarsframework

Adds the initial content definition for each of the 7 pillars. Later extended to cover the 8th Agentic pillar (RFC-0012).

Author: sascha-lewandowski Opened: 2025-12-07Decided: 2025-12-07Implemented: 2025-12-07Discussion: GitHub →PR: #3
RFCRFC-0004 Documentation migration to AsciiDoc / Antora
implementeddocsdocsantoraasciidoc

Migrates all framework documentation from Markdown to AsciiDoc and establishes Antora as the documentation build system with component versioning.

Author: t1murl Opened: 2026-02-20Decided: 2026-02-26Implemented: 2026-02-26Discussion: GitHub →PR: #4
RFCRFC-0005 Contribution metadata — CONTRIBUTING, CODE_OF_CONDUCT, SECURITY
implementedgovernancegovernanceoss-health

Adds the standard open-source health files to the framework repository.

Author: sascha-lewandowski Opened: 2026-02-06Decided: 2026-02-08Implemented: 2026-02-08Discussion: GitHub →PR: #6
RFCRFC-0006 Sovereign pillar (Pillar 7) — initial controls
implementedframeworkpillarssovereigncontrols

Introduces the Sovereign pillar as the 7th pillar of Wombat with 10 initial controls (WAF-SOV-010 through WAF-SOV-100).

Author: sascha-lewandowski Opened: 2026-02-14Decided: 2026-03-04Implemented: 2026-03-04Discussion: GitHub →
RFCRFC-0007 Governance refactor — modular best practices, case studies and navigation
implementedframeworkpillarsgovernancedocs

Restructures the Governance pillar into modular best-practice pages and adds case-study content.

Author: sascha-lewandowski Opened: 2026-02-24Decided: 2026-03-04Implemented: 2026-03-04Discussion: GitHub →PR: #10
RFCRFC-0008 Controls schema v1 — machine-readable YAML specification
implementedtoolingcontrolsschematooling

Defines a formal schema for Wombat controls YAML files, enabling validation and tooling integration for the 83+ controls library.

Author: sascha-lewandowski Opened: 2026-03-10Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0009 PASS scoring model — formal specification for v1.0
implementedframeworkscoringpassframework

Formalises the PASS scoring model as a normative specification for tier definitions, calculation rules, aggregation logic, and versioning contract.

Author: t1murl Opened: 2026-03-08Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0010 Assessment tooling — CLI and scorecard approach
implementedtoolingtoolingpassclidashboard

Defines the approach for official Wombat assessment tooling including the WOMBATpass CLI, server, dashboard, and web scorecard.

Author: sascha-lewandowski Opened: 2026-03-11Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0011 CI/CD pipeline for framework and tooling repositories
implementedtoolingcitoolingautomation

Introduces automated checks and release workflows for framework, wafpass-core, wafpass-server, and wafpass-dashboard repositories.

Author: t1murl Opened: 2026-03-11Decided: 2026-03-22Implemented: 2026-03-22Discussion: GitHub →
RFCRFC-0012 Agentic pillar as the 8th pillar
implementedframeworkpillarsagenticcontrols

Adds the Agentic pillar as the 8th pillar of Wombat with 10 initial controls, regulatory mappings, and bilingual documentation.

Author: sascha-lewandowski Opened: 2026-07-01Decided: 2026-07-05Implemented: 2026-07-05Discussion: GitHub →PR: #19

Core

RFCRFC-0013 WOMBATpass support for Pillar-8 Agentic
implementedtoolingtoolingpassagentic

Extends WOMBATpass CLI, server, and dashboard to evaluate the Agentic pillar controls as part of a full PASS assessment.

Author: sascha-lewandowski Opened: 2026-05-20Decided: 2026-05-27Implemented: 2026-05-27Discussion: GitHub →PR: #28
RFCRFC-0014 WOMBATpass CLI / Server / Dashboard v1.1.0 release
implementedtoolingreleasetoolingpassserverdashboard

Releases WOMBATpass CLI v1.1.0, Server v1.1.0, and Dashboard v1.1.0 with Pillar-8 Agentic support, detection fixes, and SINA Cloud region detection.

Author: sascha-lewandowski Opened: 2026-06-28Decided: 2026-07-05Implemented: 2026-07-05Discussion: GitHub →PR: #31
RFCRFC-GH-wafpass-core-41 Feature Request: Comprehensive Test/Quality Coverage Implementation Plan
opentoolingtoolingtestingquality

Unify fragmented test and coverage strategy across wafpass-core, server, and dashboard.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #41
RFCRFC-GH-wafpass-core-42 Feature Request: API Versioning and Backwards-Compatibility Strategy for WOMBATpass
opentoolingtoolingapiversioning

Define API maturity, backwards-compatibility rules, and versioning strategy for WOMBATpass APIs.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #42
RFCRFC-GH-wafpass-core-43 Feature Request: Source Snapshots — Ingestion Contract and Reliable Upload Path
opentoolingtoolingcontractingestion

Define a reliable source-snapshot ingestion contract so dashboard preview and auto-fix work consistently.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #43
RFCRFC-GH-wafpass-core-40 Feature Request: Dashboard UX Overhaul — Guided Onboarding, Role-Based Landing, and Progressive Disclosure
opentoolingtoolingdashboardux

Reduce dashboard navigation fragmentation and add guided onboarding with role-based landing pages.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #40
RFCRFC-GH-wafpass-core-39 Feature Request: Implement Action-Oriented Notifications
opentoolingtoolingdashboardnotifications

Make dashboard notifications actionable instead of passive text displays.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #39
RFCRFC-GH-wafpass-core-38 Feature Request: Implement Control Packs Marketplace
opentoolingtoolingmarketplacecontrols

Expand the control-packs feature beyond admin-only uploads to a real marketplace with discovery and governance.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #38
RFCRFC-GH-wafpass-core-37 Feature Request: Implement Maturity-Tier Enforcement Policy Gates
opentoolingtoolingmaturitycicd

Tie maturity tiers to CI/CD policy gates so pipelines can block promotion below a target tier.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #37

Core · Abiertas a revisión

RFCRFC-GH-wafpass-core-41 Feature Request: Comprehensive Test/Quality Coverage Implementation Plan
opentoolingtoolingtestingquality

Unify fragmented test and coverage strategy across wafpass-core, server, and dashboard.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #41
RFCRFC-GH-wafpass-core-42 Feature Request: API Versioning and Backwards-Compatibility Strategy for WOMBATpass
opentoolingtoolingapiversioning

Define API maturity, backwards-compatibility rules, and versioning strategy for WOMBATpass APIs.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #42
RFCRFC-GH-wafpass-core-43 Feature Request: Source Snapshots — Ingestion Contract and Reliable Upload Path
opentoolingtoolingcontractingestion

Define a reliable source-snapshot ingestion contract so dashboard preview and auto-fix work consistently.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #43
RFCRFC-GH-wafpass-core-40 Feature Request: Dashboard UX Overhaul — Guided Onboarding, Role-Based Landing, and Progressive Disclosure
opentoolingtoolingdashboardux

Reduce dashboard navigation fragmentation and add guided onboarding with role-based landing pages.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #40
RFCRFC-GH-wafpass-core-39 Feature Request: Implement Action-Oriented Notifications
opentoolingtoolingdashboardnotifications

Make dashboard notifications actionable instead of passive text displays.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #39
RFCRFC-GH-wafpass-core-38 Feature Request: Implement Control Packs Marketplace
opentoolingtoolingmarketplacecontrols

Expand the control-packs feature beyond admin-only uploads to a real marketplace with discovery and governance.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #38
RFCRFC-GH-wafpass-core-37 Feature Request: Implement Maturity-Tier Enforcement Policy Gates
opentoolingtoolingmaturitycicd

Tie maturity tiers to CI/CD policy gates so pipelines can block promotion below a target tier.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #37
No hay borradores para Core.

Core · Decididas / implementadas

RFCRFC-0013 WOMBATpass support for Pillar-8 Agentic
implementedtoolingtoolingpassagentic

Extends WOMBATpass CLI, server, and dashboard to evaluate the Agentic pillar controls as part of a full PASS assessment.

Author: sascha-lewandowski Opened: 2026-05-20Decided: 2026-05-27Implemented: 2026-05-27Discussion: GitHub →PR: #28
RFCRFC-0014 WOMBATpass CLI / Server / Dashboard v1.1.0 release
implementedtoolingreleasetoolingpassserverdashboard

Releases WOMBATpass CLI v1.1.0, Server v1.1.0, and Dashboard v1.1.0 with Pillar-8 Agentic support, detection fixes, and SINA Cloud region detection.

Author: sascha-lewandowski Opened: 2026-06-28Decided: 2026-07-05Implemented: 2026-07-05Discussion: GitHub →PR: #31
No hay RFC para Server.
No hay RFC abiertas para Server.
No hay borradores para Server.
No hay RFC decididas ni implementadas para Server.
No hay RFC para Dashboard.
No hay RFC abiertas para Dashboard.
No hay borradores para Dashboard.
No hay RFC decididas ni implementadas para Dashboard.
No hay RFC para Action.
No hay RFC abiertas para Action.
No hay borradores para Action.
No hay RFC decididas ni implementadas para Action.

MCP

RFCRFC-GH-wafpass-mcp-7 RFC-5: Role-aware natural tool aliasing
opentoolingtoolingmcpai

Allow curated aliases for long auto-generated MCP tool names so LLMs can match them more naturally.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #7
RFCRFC-GH-wafpass-mcp-4 RFC-2: MCP resource-level read-only endpoints
opentoolingtoolingmcpapi

Add MCP Resource definitions for run://{run_id}, control://{id}, etc. to expose read-only data without multiple tool calls.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #4
RFCRFC-GH-wafpass-mcp-6 RFC-4: Multi-step remediation plans (apply with rollback)
opentoolingtoolingmcpauto-fix

Extend auto-fix/classify with an apply step that records changes and supports rollback.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #6
RFCRFC-GH-wafpass-mcp-5 RFC-3: Streaming/paginated tool results for large runs
opentoolingtoolingmcpperformance

Add cursor-based pagination helpers so large runs do not blow MCP message size limits.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #5
RFCRFC-GH-wafpass-mcp-3 RFC-1: Auto-fix default templates for WOMBATpass controls
opentoolingtoolingmcpcontrolsauto-fix

Add fix blocks to control YAMLs or a central provider registry so common assertions get default patches.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #3

MCP · Abiertas a revisión

RFCRFC-GH-wafpass-mcp-7 RFC-5: Role-aware natural tool aliasing
opentoolingtoolingmcpai

Allow curated aliases for long auto-generated MCP tool names so LLMs can match them more naturally.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #7
RFCRFC-GH-wafpass-mcp-4 RFC-2: MCP resource-level read-only endpoints
opentoolingtoolingmcpapi

Add MCP Resource definitions for run://{run_id}, control://{id}, etc. to expose read-only data without multiple tool calls.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #4
RFCRFC-GH-wafpass-mcp-6 RFC-4: Multi-step remediation plans (apply with rollback)
opentoolingtoolingmcpauto-fix

Extend auto-fix/classify with an apply step that records changes and supports rollback.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #6
RFCRFC-GH-wafpass-mcp-5 RFC-3: Streaming/paginated tool results for large runs
opentoolingtoolingmcpperformance

Add cursor-based pagination helpers so large runs do not blow MCP message size limits.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #5
RFCRFC-GH-wafpass-mcp-3 RFC-1: Auto-fix default templates for WOMBATpass controls
opentoolingtoolingmcpcontrolsauto-fix

Add fix blocks to control YAMLs or a central provider registry so common assertions get default patches.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #3
No hay borradores para MCP.
No hay RFC decididas ni implementadas para MCP.

Framework

RFCRFC-0001 Initial 7-pillar framework structure
implementedframeworkpillarsframework

Establishes the core seven-pillar model as the foundational structure of Wombat. Extended to eight pillars by RFC-0012.

Author: sascha-lewandowski Opened: 2025-12-05Decided: 2025-12-05Implemented: 2025-12-05Discussion: GitHub →PR: #1
RFCRFC-0002 Public 2026 roadmap and milestone planning
implementedgovernanceroadmapgovernance

Defines the public roadmap for 2026 covering Q1–Q4 milestones, v1.0 target, pilot programme, and foundation readiness goals.

Author: sascha-lewandowski Opened: 2025-12-06Decided: 2025-12-06Implemented: 2025-12-06Discussion: GitHub →PR: #2
RFCRFC-0003 Pillar descriptions and key questions — 7 pillars
implementedframeworkpillarsframework

Adds the initial content definition for each of the 7 pillars. Later extended to cover the 8th Agentic pillar (RFC-0012).

Author: sascha-lewandowski Opened: 2025-12-07Decided: 2025-12-07Implemented: 2025-12-07Discussion: GitHub →PR: #3
RFCRFC-0004 Documentation migration to AsciiDoc / Antora
implementeddocsdocsantoraasciidoc

Migrates all framework documentation from Markdown to AsciiDoc and establishes Antora as the documentation build system with component versioning.

Author: t1murl Opened: 2026-02-20Decided: 2026-02-26Implemented: 2026-02-26Discussion: GitHub →PR: #4
RFCRFC-0005 Contribution metadata — CONTRIBUTING, CODE_OF_CONDUCT, SECURITY
implementedgovernancegovernanceoss-health

Adds the standard open-source health files to the framework repository.

Author: sascha-lewandowski Opened: 2026-02-06Decided: 2026-02-08Implemented: 2026-02-08Discussion: GitHub →PR: #6
RFCRFC-0006 Sovereign pillar (Pillar 7) — initial controls
implementedframeworkpillarssovereigncontrols

Introduces the Sovereign pillar as the 7th pillar of Wombat with 10 initial controls (WAF-SOV-010 through WAF-SOV-100).

Author: sascha-lewandowski Opened: 2026-02-14Decided: 2026-03-04Implemented: 2026-03-04Discussion: GitHub →
RFCRFC-0007 Governance refactor — modular best practices, case studies and navigation
implementedframeworkpillarsgovernancedocs

Restructures the Governance pillar into modular best-practice pages and adds case-study content.

Author: sascha-lewandowski Opened: 2026-02-24Decided: 2026-03-04Implemented: 2026-03-04Discussion: GitHub →PR: #10
RFCRFC-0008 Controls schema v1 — machine-readable YAML specification
implementedtoolingcontrolsschematooling

Defines a formal schema for Wombat controls YAML files, enabling validation and tooling integration for the 83+ controls library.

Author: sascha-lewandowski Opened: 2026-03-10Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0009 PASS scoring model — formal specification for v1.0
implementedframeworkscoringpassframework

Formalises the PASS scoring model as a normative specification for tier definitions, calculation rules, aggregation logic, and versioning contract.

Author: t1murl Opened: 2026-03-08Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0010 Assessment tooling — CLI and scorecard approach
implementedtoolingtoolingpassclidashboard

Defines the approach for official Wombat assessment tooling including the WOMBATpass CLI, server, dashboard, and web scorecard.

Author: sascha-lewandowski Opened: 2026-03-11Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0011 CI/CD pipeline for framework and tooling repositories
implementedtoolingcitoolingautomation

Introduces automated checks and release workflows for framework, wafpass-core, wafpass-server, and wafpass-dashboard repositories.

Author: t1murl Opened: 2026-03-11Decided: 2026-03-22Implemented: 2026-03-22Discussion: GitHub →
RFCRFC-0012 Agentic pillar as the 8th pillar
implementedframeworkpillarsagenticcontrols

Adds the Agentic pillar as the 8th pillar of Wombat with 10 initial controls, regulatory mappings, and bilingual documentation.

Author: sascha-lewandowski Opened: 2026-07-01Decided: 2026-07-05Implemented: 2026-07-05Discussion: GitHub →PR: #19
RFCRFC-0016 Control-level remediation playbooks
draftframeworkcontrolsremediationframework

Standardises machine- and human-readable remediation guidance for every Wombat control so operators can act on findings directly.

Author: sascha-lewandowski Opened: 2026-07-08Discussion: GitHub →
RFCRFC-0017 Multi-cloud provider expansion beyond AWS and SINA Cloud
drafttoolingtoolingcloud-providersawsazuregcp

Defines how WOMBATpass detection and controls will be extended to cover Azure, GCP, and other cloud providers while keeping the framework cloud-agnostic.

Author: sascha-lewandowski Opened: 2026-07-08Discussion: GitHub →
RFCRFC-GH-framework-26 RFC: Quality Assurance
opendocsdocscilinting

CI checks for dead xrefs, unregistered nav.adoc files, and control-schema consistency between YAML, AsciiDoc, and navigation.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #26
RFCRFC-GH-framework-25 RFC: Expand Sovereign & Resources
opendocsdocssovereignresources

Expand Sovereign definitions, evidence matrix, and create real overview/glossary pages for resources and wording.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #25
RFCRFC-GH-framework-23 RFC: Complete the Agentic Pillar
opendocsdocsagenticpillars

Complete Agentic pillar maturity, evidence, glossary, and best-practice pages with examples.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #23
RFCRFC-GH-framework-22 RFC: Consolidate Navigation & Links
opendocsdocsnavigationlinks

Standardise module links, convert relative xrefs to module-prefixed xrefs, and clean Markdown links.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #22
RFCRFC-GH-framework-21 RFC: Finalize Antora Structure
opendocsdocsantorastructure

Finalise antora.yml registration, create pillar-security nav, update README/AGENTS for 8-module layout.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #21
RFCRFC-GH-framework-24 RFC: Correct and Expand the Controls Catalog
opendocsdocscontrolscatalog

Align controls to 8 pillars, add Agentic, and extend control-schema.adoc.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #24

Core

RFCRFC-0013 WOMBATpass support for Pillar-8 Agentic
implementedtoolingtoolingpassagentic

Extends WOMBATpass CLI, server, and dashboard to evaluate the Agentic pillar controls as part of a full PASS assessment.

Author: sascha-lewandowski Opened: 2026-05-20Decided: 2026-05-27Implemented: 2026-05-27Discussion: GitHub →PR: #28
RFCRFC-0014 WOMBATpass CLI / Server / Dashboard v1.1.0 release
implementedtoolingreleasetoolingpassserverdashboard

Releases WOMBATpass CLI v1.1.0, Server v1.1.0, and Dashboard v1.1.0 with Pillar-8 Agentic support, detection fixes, and SINA Cloud region detection.

Author: sascha-lewandowski Opened: 2026-06-28Decided: 2026-07-05Implemented: 2026-07-05Discussion: GitHub →PR: #31
RFCRFC-GH-wafpass-core-41 Feature Request: Comprehensive Test/Quality Coverage Implementation Plan
opentoolingtoolingtestingquality

Unify fragmented test and coverage strategy across wafpass-core, server, and dashboard.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #41
RFCRFC-GH-wafpass-core-42 Feature Request: API Versioning and Backwards-Compatibility Strategy for WOMBATpass
opentoolingtoolingapiversioning

Define API maturity, backwards-compatibility rules, and versioning strategy for WOMBATpass APIs.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #42
RFCRFC-GH-wafpass-core-43 Feature Request: Source Snapshots — Ingestion Contract and Reliable Upload Path
opentoolingtoolingcontractingestion

Define a reliable source-snapshot ingestion contract so dashboard preview and auto-fix work consistently.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #43
RFCRFC-GH-wafpass-core-40 Feature Request: Dashboard UX Overhaul — Guided Onboarding, Role-Based Landing, and Progressive Disclosure
opentoolingtoolingdashboardux

Reduce dashboard navigation fragmentation and add guided onboarding with role-based landing pages.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #40
RFCRFC-GH-wafpass-core-39 Feature Request: Implement Action-Oriented Notifications
opentoolingtoolingdashboardnotifications

Make dashboard notifications actionable instead of passive text displays.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #39
RFCRFC-GH-wafpass-core-38 Feature Request: Implement Control Packs Marketplace
opentoolingtoolingmarketplacecontrols

Expand the control-packs feature beyond admin-only uploads to a real marketplace with discovery and governance.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #38
RFCRFC-GH-wafpass-core-37 Feature Request: Implement Maturity-Tier Enforcement Policy Gates
opentoolingtoolingmaturitycicd

Tie maturity tiers to CI/CD policy gates so pipelines can block promotion below a target tier.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #37

MCP

RFCRFC-GH-wafpass-mcp-7 RFC-5: Role-aware natural tool aliasing
opentoolingtoolingmcpai

Allow curated aliases for long auto-generated MCP tool names so LLMs can match them more naturally.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #7
RFCRFC-GH-wafpass-mcp-4 RFC-2: MCP resource-level read-only endpoints
opentoolingtoolingmcpapi

Add MCP Resource definitions for run://{run_id}, control://{id}, etc. to expose read-only data without multiple tool calls.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #4
RFCRFC-GH-wafpass-mcp-6 RFC-4: Multi-step remediation plans (apply with rollback)
opentoolingtoolingmcpauto-fix

Extend auto-fix/classify with an apply step that records changes and supports rollback.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #6
RFCRFC-GH-wafpass-mcp-5 RFC-3: Streaming/paginated tool results for large runs
opentoolingtoolingmcpperformance

Add cursor-based pagination helpers so large runs do not blow MCP message size limits.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #5
RFCRFC-GH-wafpass-mcp-3 RFC-1: Auto-fix default templates for WOMBATpass controls
opentoolingtoolingmcpcontrolsauto-fix

Add fix blocks to control YAMLs or a central provider registry so common assertions get default patches.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #3

Framework

RFCRFC-0015 Website radical redesign — apply dark-first theme to all public pages
opendocsdocswebsitedesign

Applies the radical dark-first design system to the remaining public pages so the whole site uses one consistent visual language.

Author: sascha-lewandowski Opened: 2026-07-06Discussion: GitHub →

MCP

RFCRFC-GH-wafpass-mcp-7 RFC-5: Role-aware natural tool aliasing
opentoolingtoolingmcpai

Allow curated aliases for long auto-generated MCP tool names so LLMs can match them more naturally.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #7
RFCRFC-GH-wafpass-mcp-4 RFC-2: MCP resource-level read-only endpoints
opentoolingtoolingmcpapi

Add MCP Resource definitions for run://{run_id}, control://{id}, etc. to expose read-only data without multiple tool calls.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #4
RFCRFC-GH-wafpass-mcp-6 RFC-4: Multi-step remediation plans (apply with rollback)
opentoolingtoolingmcpauto-fix

Extend auto-fix/classify with an apply step that records changes and supports rollback.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #6
RFCRFC-GH-wafpass-mcp-5 RFC-3: Streaming/paginated tool results for large runs
opentoolingtoolingmcpperformance

Add cursor-based pagination helpers so large runs do not blow MCP message size limits.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #5
RFCRFC-GH-wafpass-mcp-3 RFC-1: Auto-fix default templates for WOMBATpass controls
opentoolingtoolingmcpcontrolsauto-fix

Add fix blocks to control YAMLs or a central provider registry so common assertions get default patches.

Author: lewandos Opened: 2026-08-14Discussion: GitHub →Issue: #3

Framework

RFCRFC-GH-framework-26 RFC: Quality Assurance
opendocsdocscilinting

CI checks for dead xrefs, unregistered nav.adoc files, and control-schema consistency between YAML, AsciiDoc, and navigation.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #26
RFCRFC-GH-framework-25 RFC: Expand Sovereign & Resources
opendocsdocssovereignresources

Expand Sovereign definitions, evidence matrix, and create real overview/glossary pages for resources and wording.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #25
RFCRFC-GH-framework-23 RFC: Complete the Agentic Pillar
opendocsdocsagenticpillars

Complete Agentic pillar maturity, evidence, glossary, and best-practice pages with examples.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #23
RFCRFC-GH-framework-22 RFC: Consolidate Navigation & Links
opendocsdocsnavigationlinks

Standardise module links, convert relative xrefs to module-prefixed xrefs, and clean Markdown links.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #22
RFCRFC-GH-framework-21 RFC: Finalize Antora Structure
opendocsdocsantorastructure

Finalise antora.yml registration, create pillar-security nav, update README/AGENTS for 8-module layout.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #21
RFCRFC-GH-framework-24 RFC: Correct and Expand the Controls Catalog
opendocsdocscontrolscatalog

Align controls to 8 pillars, add Agentic, and extend control-schema.adoc.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #24

Core

RFCRFC-GH-wafpass-core-41 Feature Request: Comprehensive Test/Quality Coverage Implementation Plan
opentoolingtoolingtestingquality

Unify fragmented test and coverage strategy across wafpass-core, server, and dashboard.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #41
RFCRFC-GH-wafpass-core-42 Feature Request: API Versioning and Backwards-Compatibility Strategy for WOMBATpass
opentoolingtoolingapiversioning

Define API maturity, backwards-compatibility rules, and versioning strategy for WOMBATpass APIs.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #42
RFCRFC-GH-wafpass-core-43 Feature Request: Source Snapshots — Ingestion Contract and Reliable Upload Path
opentoolingtoolingcontractingestion

Define a reliable source-snapshot ingestion contract so dashboard preview and auto-fix work consistently.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #43
RFCRFC-GH-wafpass-core-40 Feature Request: Dashboard UX Overhaul — Guided Onboarding, Role-Based Landing, and Progressive Disclosure
opentoolingtoolingdashboardux

Reduce dashboard navigation fragmentation and add guided onboarding with role-based landing pages.

Author: lewandos Opened: 2026-07-18Discussion: GitHub →Issue: #40
RFCRFC-GH-wafpass-core-39 Feature Request: Implement Action-Oriented Notifications
opentoolingtoolingdashboardnotifications

Make dashboard notifications actionable instead of passive text displays.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #39
RFCRFC-GH-wafpass-core-38 Feature Request: Implement Control Packs Marketplace
opentoolingtoolingmarketplacecontrols

Expand the control-packs feature beyond admin-only uploads to a real marketplace with discovery and governance.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #38
RFCRFC-GH-wafpass-core-37 Feature Request: Implement Maturity-Tier Enforcement Policy Gates
opentoolingtoolingmaturitycicd

Tie maturity tiers to CI/CD policy gates so pipelines can block promotion below a target tier.

Author: lewandos Opened: 2026-07-17Discussion: GitHub →Issue: #37

Framework

RFCRFC-0016 Control-level remediation playbooks
draftframeworkcontrolsremediationframework

Standardises machine- and human-readable remediation guidance for every Wombat control so operators can act on findings directly.

Author: sascha-lewandowski Opened: 2026-07-08Discussion: GitHub →
RFCRFC-0017 Multi-cloud provider expansion beyond AWS and SINA Cloud
drafttoolingtoolingcloud-providersawsazuregcp

Defines how WOMBATpass detection and controls will be extended to cover Azure, GCP, and other cloud providers while keeping the framework cloud-agnostic.

Author: sascha-lewandowski Opened: 2026-07-08Discussion: GitHub →

Framework

RFCRFC-0001 Initial 7-pillar framework structure
implementedframeworkpillarsframework

Establishes the core seven-pillar model as the foundational structure of Wombat. Extended to eight pillars by RFC-0012.

Author: sascha-lewandowski Opened: 2025-12-05Decided: 2025-12-05Implemented: 2025-12-05Discussion: GitHub →PR: #1
RFCRFC-0002 Public 2026 roadmap and milestone planning
implementedgovernanceroadmapgovernance

Defines the public roadmap for 2026 covering Q1–Q4 milestones, v1.0 target, pilot programme, and foundation readiness goals.

Author: sascha-lewandowski Opened: 2025-12-06Decided: 2025-12-06Implemented: 2025-12-06Discussion: GitHub →PR: #2
RFCRFC-0003 Pillar descriptions and key questions — 7 pillars
implementedframeworkpillarsframework

Adds the initial content definition for each of the 7 pillars. Later extended to cover the 8th Agentic pillar (RFC-0012).

Author: sascha-lewandowski Opened: 2025-12-07Decided: 2025-12-07Implemented: 2025-12-07Discussion: GitHub →PR: #3
RFCRFC-0004 Documentation migration to AsciiDoc / Antora
implementeddocsdocsantoraasciidoc

Migrates all framework documentation from Markdown to AsciiDoc and establishes Antora as the documentation build system with component versioning.

Author: t1murl Opened: 2026-02-20Decided: 2026-02-26Implemented: 2026-02-26Discussion: GitHub →PR: #4
RFCRFC-0005 Contribution metadata — CONTRIBUTING, CODE_OF_CONDUCT, SECURITY
implementedgovernancegovernanceoss-health

Adds the standard open-source health files to the framework repository.

Author: sascha-lewandowski Opened: 2026-02-06Decided: 2026-02-08Implemented: 2026-02-08Discussion: GitHub →PR: #6
RFCRFC-0006 Sovereign pillar (Pillar 7) — initial controls
implementedframeworkpillarssovereigncontrols

Introduces the Sovereign pillar as the 7th pillar of Wombat with 10 initial controls (WAF-SOV-010 through WAF-SOV-100).

Author: sascha-lewandowski Opened: 2026-02-14Decided: 2026-03-04Implemented: 2026-03-04Discussion: GitHub →
RFCRFC-0007 Governance refactor — modular best practices, case studies and navigation
implementedframeworkpillarsgovernancedocs

Restructures the Governance pillar into modular best-practice pages and adds case-study content.

Author: sascha-lewandowski Opened: 2026-02-24Decided: 2026-03-04Implemented: 2026-03-04Discussion: GitHub →PR: #10
RFCRFC-0008 Controls schema v1 — machine-readable YAML specification
implementedtoolingcontrolsschematooling

Defines a formal schema for Wombat controls YAML files, enabling validation and tooling integration for the 83+ controls library.

Author: sascha-lewandowski Opened: 2026-03-10Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0009 PASS scoring model — formal specification for v1.0
implementedframeworkscoringpassframework

Formalises the PASS scoring model as a normative specification for tier definitions, calculation rules, aggregation logic, and versioning contract.

Author: t1murl Opened: 2026-03-08Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0010 Assessment tooling — CLI and scorecard approach
implementedtoolingtoolingpassclidashboard

Defines the approach for official Wombat assessment tooling including the WOMBATpass CLI, server, dashboard, and web scorecard.

Author: sascha-lewandowski Opened: 2026-03-11Decided: 2026-05-12Implemented: 2026-05-12Discussion: GitHub →
RFCRFC-0011 CI/CD pipeline for framework and tooling repositories
implementedtoolingcitoolingautomation

Introduces automated checks and release workflows for framework, wafpass-core, wafpass-server, and wafpass-dashboard repositories.

Author: t1murl Opened: 2026-03-11Decided: 2026-03-22Implemented: 2026-03-22Discussion: GitHub →
RFCRFC-0012 Agentic pillar as the 8th pillar
implementedframeworkpillarsagenticcontrols

Adds the Agentic pillar as the 8th pillar of Wombat with 10 initial controls, regulatory mappings, and bilingual documentation.

Author: sascha-lewandowski Opened: 2026-07-01Decided: 2026-07-05Implemented: 2026-07-05Discussion: GitHub →PR: #19

Core

RFCRFC-0013 WOMBATpass support for Pillar-8 Agentic
implementedtoolingtoolingpassagentic

Extends WOMBATpass CLI, server, and dashboard to evaluate the Agentic pillar controls as part of a full PASS assessment.

Author: sascha-lewandowski Opened: 2026-05-20Decided: 2026-05-27Implemented: 2026-05-27Discussion: GitHub →PR: #28
RFCRFC-0014 WOMBATpass CLI / Server / Dashboard v1.1.0 release
implementedtoolingreleasetoolingpassserverdashboard

Releases WOMBATpass CLI v1.1.0, Server v1.1.0, and Dashboard v1.1.0 with Pillar-8 Agentic support, detection fixes, and SINA Cloud region detection.

Author: sascha-lewandowski Opened: 2026-06-28Decided: 2026-07-05Implemented: 2026-07-05Discussion: GitHub →PR: #31

¿Quieres proponer un cambio?

Abre una discusión en GitHub con la plantilla de RFC. La comunidad la revisa, los maintainers deciden y todo queda documentado y trazable.

Architecture Decision Records.

Los ADR recogen las decisiones estructurales y transversales que dan forma al ecosistema Wombat, sus repositorios y sus contratos.

ADRADR-000 Wombat Federated Repository Architecture & Onboarding Overview
acceptedarchitectureonboardingumbrella

Master onboarding document explaining the Wombat ecosystem, repository layout, two-branch documentation model, and central wafpass-result.json contract.

Author: sascha-lewandowski Date: 2026-09-17Record: GitHub →Repos: framework, waf2p.github.io, wafpass-core, wafpass-server, wafpass-dashboard, wafpass-mcp, wafpass-action
ADRADR-001 The wafpass-result.json Contract
acceptedcontractwafpass-corewafpass-serverdashboard

Defines the single JSON schema that all Wombat components use to exchange scan results, findings, waivers, risks, and metadata.

Author: sascha-lewandowski Date: 2026-09-17Record: GitHub →Repos: wafpass-core, wafpass-server, wafpass-dashboard
ADRADR-002 Two Long-Lived Branches for German and English Framework Documentation
accepteddocsframeworklocalizationi18n

Uses main-de and main-en branches (checked out as framework/ and framework-en/) so German and English Antora component releases can evolve independently.

Author: sascha-lewandowski Date: 2026-09-17Record: GitHub →Repos: framework
No hay ADR propuestos.
ADRADR-000 Wombat Federated Repository Architecture & Onboarding Overview
acceptedarchitectureonboardingumbrella

Master onboarding document explaining the Wombat ecosystem, repository layout, two-branch documentation model, and central wafpass-result.json contract.

Author: sascha-lewandowski Date: 2026-09-17Record: GitHub →Repos: framework, waf2p.github.io, wafpass-core, wafpass-server, wafpass-dashboard, wafpass-mcp, wafpass-action
ADRADR-001 The wafpass-result.json Contract
acceptedcontractwafpass-corewafpass-serverdashboard

Defines the single JSON schema that all Wombat components use to exchange scan results, findings, waivers, risks, and metadata.

Author: sascha-lewandowski Date: 2026-09-17Record: GitHub →Repos: wafpass-core, wafpass-server, wafpass-dashboard
ADRADR-002 Two Long-Lived Branches for German and English Framework Documentation
accepteddocsframeworklocalizationi18n

Uses main-de and main-en branches (checked out as framework/ and framework-en/) so German and English Antora component releases can evolve independently.

Author: sascha-lewandowski Date: 2026-09-17Record: GitHub →Repos: framework
No hay ADR obsoletos.
No hay ADR reemplazados.

Registro de decisiones legible por máquina

Todas las RFC y los ADR están disponibles también como un único archivo YAML que pueden procesar herramientas, scripts y sistemas posteriores. El registro incluye estados, categorías, repositorios, etiquetas y enlaces directos a cada entrada.

Descargar registry.yml

¿Qué requiere una RFC?

No todos los cambios necesitan una RFC, solo los importantes. Usa la tabla de abajo para decidir.

Tipo de cambio ¿Hace falta RFC? Proceso
Nuevo pilar o eliminación de un pilar Sí RFC → votación del TSC → PR
Cambios en el modelo de puntuación (niveles PASS, pesos) Sí RFC → votación del TSC → PR
Cambio incompatible en el esquema o los ID de los controles Sí RFC → votación del TSC → PR
Propuesta de un nuevo grupo de trabajo Sí RFC → lazy consensus → carta publicada
Cambios de gobernanza o de roles Sí RFC → mayoría cualificada del TSC
Nuevo control (compatible, aditivo) Recomendado PR con enlace a la discusión, lazy consensus
Redacción de la documentación, erratas, traducciones No Solo PR
Contenido del sitio web, entradas del blog No Solo PR

Flujo de estados de una RFC.

Cada RFC sigue el mismo camino documentado, desde el primer borrador hasta la decisión cerrada.

draft
La autoría redacta la propuesta en GitHub Discussions
open
Mínimo 5 días hábiles abierta a comentarios de la comunidad
accepted
Votación del TSC o lazy consensus, documentada públicamente
implemented
PR fusionado, entrada en el registro de cambios añadida, RFC cerrada
Resultados alternativos: rejected (no aceptada tras la revisión), withdrawn (retirada por la autoría). Ambos se documentan con sus motivos.

Cómo escribir una buena RFC.

Tres cosas que marcan la diferencia entre una RFC que avanza rápido y una que se estanca.

Plantea el problema, no la solución

Empieza por lo que falla o falta, no por lo que quieres construir. Los revisores deben coincidir en que el problema es real antes de poder valorar tu propuesta. Explica el «porqué» antes del «qué».

Muestra compromisos y alternativas

Una buena RFC explica qué otras opciones se consideraron y por qué se descartaron. Ahorra rondas de revisión y da contexto a futuros maintainers cuando la autoría original ya no esté.

Concreta el impacto

¿A quién afecta? ¿Qué repositorios, archivos o contratos públicos cambian? Cuanto más claro el alcance, antes podrá la comunidad dar feedback útil y un maintainer tomar una decisión.

Da forma a la próxima decisión.

Elige una RFC abierta, comparte tu punto de vista o abre una nueva. El framework se construye en público y cada voz cuenta.