Construído em público.

Toda mudança relevante no Wombat começa com uma Request for Comments ou um Architecture Decision Record público. Esta página acompanha cada decisão, do primeiro rascunho ao merge, para que nada fique escondido.

38
Total de decisões
35
RFCs
19
Abertas para revisão
14
Implementadas
3
ADRs
3
ADRs aceitos

Todas as Requests for Comments.

Filtre por projeto e status, leia os resumos e acompanhe as discussões e pull requests vinculados.

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 · Abertas para revisão

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 · Rascunhos

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 · Abertas para revisão

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
Nenhum rascunho 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
Nenhuma RFC para Server.
Nenhuma RFC aberta para Server.
Nenhum rascunho para Server.
Nenhuma RFC decidida ou implementada para Server.
Nenhuma RFC para Dashboard.
Nenhuma RFC aberta para Dashboard.
Nenhum rascunho para Dashboard.
Nenhuma RFC decidida ou implementada para Dashboard.
Nenhuma RFC para Action.
Nenhuma RFC aberta para Action.
Nenhum rascunho para Action.
Nenhuma RFC decidida ou implementada 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 · Abertas para revisão

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
Nenhum rascunho para MCP.
Nenhuma RFC decidida ou implementada 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

Quer propor uma mudança?

Abra uma discussão no GitHub com o modelo de RFC. A comunidade revisa, os mantenedores decidem e tudo fica documentado e rastreável.

Architecture Decision Records.

Os ADRs registram as decisões estruturais e transversais que dão forma ao ecossistema Wombat, seus repositórios e 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
Nenhum ADR proposto.
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
Nenhum ADR obsoleto.
Nenhum ADR substituído.

Registro de decisões legível por máquina

Todas as RFCs e ADRs também estão disponíveis num único arquivo YAML que ferramentas, scripts e sistemas subsequentes podem processar. O registro inclui status, categorias, repositórios, tags e links diretos para cada entrada.

Baixar registry.yml

O que exige uma RFC?

Nem toda mudança precisa de uma RFC, só as relevantes. Use a tabela abaixo para decidir.

Tipo de mudança Precisa de RFC? Processo
Novo pilar ou remoção de um pilar Sim RFC → votação do TSC → PR
Mudanças no modelo de pontuação (níveis PASS, pesos) Sim RFC → votação do TSC → PR
Mudança incompatível no esquema ou nos IDs dos controles Sim RFC → votação do TSC → PR
Proposta de novo grupo de trabalho Sim RFC → lazy consensus → carta publicada
Mudanças de governança ou de papéis Sim RFC → maioria qualificada do TSC
Novo controle (compatível, aditivo) Recomendado PR com link para a discussão, lazy consensus
Redação da documentação, erros de digitação, traduções Não Só PR
Conteúdo do site, posts do blog Não Só PR

Fluxo de status de uma RFC.

Toda RFC segue o mesmo caminho documentado, do primeiro rascunho à decisão encerrada.

draft
A autoria redige a proposta no GitHub Discussions
open
No mínimo 5 dias úteis aberta a comentários da comunidade
accepted
Votação do TSC ou lazy consensus, documentada publicamente
implemented
PR mesclado, entrada no registro de alterações adicionada, RFC encerrada
Resultados alternativos: rejected (não aceita após revisão), withdrawn (retirada pela autoria). Ambos são documentados com os motivos.

Como escrever uma boa RFC.

Três coisas que fazem a diferença entre uma RFC que avança rápido e uma que trava.

Descreva o problema, não a solução

Comece pelo que está quebrado ou faltando, não pelo que você quer construir. Os revisores precisam concordar que o problema é real antes de avaliar a solução proposta. Explique o “porquê” antes do “o quê”.

Mostre trade-offs e alternativas

Uma boa RFC explica o que mais foi considerado e por que foi descartado. Isso poupa rodadas de revisão e dá contexto a futuros mantenedores quando a autoria original já não estiver presente.

Seja específico sobre o impacto

Quem é afetado? Quais repositórios, arquivos ou contratos públicos mudam? Quanto mais claro o escopo, mais rápido a comunidade dá feedback útil e um mantenedor decide.

Ajude a moldar a próxima decisão.

Escolha uma RFC aberta, compartilhe sua perspectiva ou abra uma nova. O framework é construído em público e cada voz conta.