Sviluppato in pubblico.

Ogni modifica rilevante a Wombat nasce da una Request for Comments o da un Architecture Decision Record pubblico. Questa pagina segue ogni decisione, dalla prima bozza al merge, così che nulla resti nascosto.

38
Decisioni totali
35
RFCs
19
Aperte alla revisione
14
Implementate
3
ADRs
3
ADR accettati

Tutte le Request for Comments.

Filtra per progetto e stato, leggi i riepiloghi e segui le discussioni e le pull request collegate.

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 · Aperte alla revisione

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

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 · Decise / implementate

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 · Aperte alla revisione

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
Nessuna bozza per Core.

Core · Decise / implementate

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
Nessun RFC per Server.
Nessun RFC aperto per Server.
Nessuna bozza per Server.
Nessun RFC deciso o implementato per Server.
Nessun RFC per Dashboard.
Nessun RFC aperto per Dashboard.
Nessuna bozza per Dashboard.
Nessun RFC deciso o implementato per Dashboard.
Nessun RFC per Action.
Nessun RFC aperto per Action.
Nessuna bozza per Action.
Nessun RFC deciso o implementato per 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 · Aperte alla revisione

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
Nessuna bozza per MCP.
Nessun RFC deciso o implementato per 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

Vuoi proporre una modifica?

Apri una discussione su GitHub con il modello RFC. La community la esamina, i maintainer decidono e tutto è documentato e tracciabile.

Architecture Decision Record.

Gli ADR registrano le decisioni strutturali e trasversali che definiscono l'ecosistema Wombat, i suoi repository e i suoi contratti.

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
Nessun 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
Nessun ADR deprecato.
Nessun ADR sostituito.

Registro delle decisioni leggibile dalle macchine

Tutti gli RFC e gli ADR sono disponibili anche come singolo file YAML, utilizzabile da strumenti, script e sistemi a valle. Il registro include stati, categorie, repository, tag e link diretti a ogni voce.

Scarica registry.yml

Cosa richiede un RFC?

Non tutte le modifiche richiedono un RFC, solo quelle rilevanti. Usa la tabella qui sotto per decidere.

Tipo di modifica Serve un RFC? Processo
Nuovo pilastro o rimozione di un pilastro Sì RFC → voto del TSC → PR
Modifiche al modello di punteggio (livelli PASS, pesi) Sì RFC → voto del TSC → PR
Modifica incompatibile allo schema o agli ID dei controlli Sì RFC → voto del TSC → PR
Proposta di un nuovo gruppo di lavoro Sì RFC → lazy consensus → statuto pubblicato
Modifiche a governance o ruoli Sì RFC → maggioranza qualificata del TSC
Nuovo controllo (compatibile, aggiuntivo) Consigliato PR con link alla discussione, lazy consensus
Formulazione della documentazione, refusi, traduzioni No Solo PR
Contenuti del sito web, articoli del blog No Solo PR

Flusso degli stati di un RFC.

Ogni RFC segue lo stesso percorso documentato, dalla prima bozza alla decisione finale.

draft
Chi propone scrive la proposta in GitHub Discussions
open
Almeno 5 giorni lavorativi aperta ai commenti della community
accepted
Voto del TSC o lazy consensus, documentato pubblicamente
implemented
PR unita, voce aggiunta al changelog, RFC chiuso
Esiti alternativi: rejected (non accettato dopo la revisione), withdrawn (ritirato da chi lo ha proposto). Entrambi sono documentati con le motivazioni.

Come scrivere un buon RFC.

Tre aspetti che fanno la differenza tra un RFC che procede spedito e uno che si arena.

Descrivi il problema, non la soluzione

Parti da ciò che non funziona o manca, non da ciò che vuoi costruire. I revisori devono concordare che il problema sia reale prima di valutare la tua soluzione. Chiarisci il «perché» prima del «cosa».

Mostra compromessi e alternative

Un buon RFC spiega cos'altro è stato valutato e perché è stato scartato. Si risparmiano cicli di revisione e i futuri maintainer hanno contesto quando chi ha proposto l'RFC non è più coinvolto.

Sii preciso sull'impatto

Chi è coinvolto? Quali repository, file o contratti pubblici cambiano? Più chiaro è l'ambito, prima la community può dare feedback utili e un maintainer può decidere.

Contribuisci alla prossima decisione.

Scegli un RFC aperto, condividi il tuo punto di vista o aprine uno nuovo. Il framework si costruisce in pubblico e ogni voce conta.