Governance · Trasparente di default

RFCTracker

Ogni cambiamento significativo a WAF++ inizia con una richiesta pubblica per i commenti o il record di decisione di architettura. Questa pagina traccia ogni decisione — dalla prima bozza alla fusione — quindi nulla è nascosto.

14implementato 19aperto per la recensione 3ADRs
38
Decisioni totali
35
RFC
19
Aperto per la recensione
14
Attuazione
3
ADRs
3
ADR accettati
Proposte

Tutte le richieste di commenti

Filtra per progetto e stato, leggere i riassunti, e seguire le discussioni collegate e tirare richieste.

Framework

RFCRFC-0001 Initial 7-pillar framework structure
implementedframeworkpillarsframework

Establishes the core seven-pillar model as the foundational structure of WAF++. 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 WAF++ 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 WAF++ 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 WAF++ assessment tooling including the WAFPass 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 WAF++ 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 WAF++ 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 WAFPass 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— Aperto per la 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— Progetti

RFCRFC-0016 Control-level remediation playbooks
draftframeworkcontrolsremediationframework

Standardises machine- and human-readable remediation guidance for every WAF++ 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 WAFPass 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— Deciso / implementato

RFCRFC-0001 Initial 7-pillar framework structure
implementedframeworkpillarsframework

Establishes the core seven-pillar model as the foundational structure of WAF++. 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 WAF++ 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 WAF++ 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 WAF++ assessment tooling including the WAFPass 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 WAF++ 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 WAFPass support for Pillar-8 Agentic
implementedtoolingtoolingpassagentic

Extends WAFPass 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 WAFPass CLI / Server / Dashboard v1.1.0 release
implementedtoolingreleasetoolingpassserverdashboard

Releases WAFPass 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 WAF++ PASS
opentoolingtoolingapiversioning

Define API maturity, backwards-compatibility rules, and versioning strategy for WAF++ PASS 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— Aperto per la 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 WAF++ PASS
opentoolingtoolingapiversioning

Define API maturity, backwards-compatibility rules, and versioning strategy for WAF++ PASS 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 perCore.

Core— Deciso / implementato

RFCRFC-0013 WAFPass support for Pillar-8 Agentic
implementedtoolingtoolingpassagentic

Extends WAFPass 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 WAFPass CLI / Server / Dashboard v1.1.0 release
implementedtoolingreleasetoolingpassserverdashboard

Releases WAFPass 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 perServer.
Nessun RFC aperto perServer.
Nessuna bozza perServer.
Nessun RFC deciso o implementato perServer.
Nessun RFC perDashboard.
Nessun RFC aperto perDashboard.
Nessuna bozza perDashboard.
Nessun RFC deciso o implementato perDashboard.
Nessun RFC perAction.
Nessun RFC aperto perAction.
Nessuna bozza perAction.
Nessun RFC deciso o implementato perAction.

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 WAFpass 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— Aperto per la 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 WAFpass 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 perMCP.
Nessun RFC deciso o implementato perMCP.

Framework

RFCRFC-0001 Initial 7-pillar framework structure
implementedframeworkpillarsframework

Establishes the core seven-pillar model as the foundational structure of WAF++. 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 WAF++ 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 WAF++ 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 WAF++ assessment tooling including the WAFPass 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 WAF++ 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 WAF++ 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 WAFPass 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 WAFPass support for Pillar-8 Agentic
implementedtoolingtoolingpassagentic

Extends WAFPass 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 WAFPass CLI / Server / Dashboard v1.1.0 release
implementedtoolingreleasetoolingpassserverdashboard

Releases WAFPass 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 WAF++ PASS
opentoolingtoolingapiversioning

Define API maturity, backwards-compatibility rules, and versioning strategy for WAF++ PASS 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 WAFpass 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 WAFpass 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 WAF++ PASS
opentoolingtoolingapiversioning

Define API maturity, backwards-compatibility rules, and versioning strategy for WAF++ PASS 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 WAF++ 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 WAFPass 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 WAF++. 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 WAF++ 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 WAF++ 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 WAF++ assessment tooling including the WAFPass 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 WAF++ 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 WAFPass support for Pillar-8 Agentic
implementedtoolingtoolingpassagentic

Extends WAFPass 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 WAFPass CLI / Server / Dashboard v1.1.0 release
implementedtoolingreleasetoolingpassserverdashboard

Releases WAFPass 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 un cambiamento?

Aprire una discussione GitHub utilizzando il modello RFC. La comunità lo esamina, i manutentori decidono — tutto è documentato e tracciabile.

Architettura

Architettura Decision Records

Gli ADR catturano le decisioni strutturali e cross-cutting che modellano l'ecosistema WAF++, i repository e i contratti.

ADRADR-000 WAF++ Federated Repository Architecture & Onboarding Overview
acceptedarchitectureonboardingumbrella

Master onboarding document explaining the WAF++ 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 WAF++ 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
Non ho proposto ADRs.
ADRADR-000 WAF++ Federated Repository Architecture & Onboarding Overview
acceptedarchitectureonboardingumbrella

Master onboarding document explaining the WAF++ 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 WAF++ 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.
Non ho superato gli ADR.

Registro delle decisioni leggibili in macchina

Tutti gli RFC e gli ADR sono disponibili anche come un unico file YAML che gli strumenti, gli script e i consumatori a valle possono parse. Il registro include stati, categorie, repository, tag e link diretti ad ogni record.

Scarica Registry.yml →
Processo

Cosa si qualifica come RFC?

Non ogni cambiamento ha bisogno di un RFC — solo quelli significativi. Utilizzare la tabella qui sotto per decidere.

Tipo di cambiamento RFC necessario? Processo
Nuovo pilastro o rimozione di un pilastro Sì. RFC → TSC vota &rr; PR
Cambiamenti del modello di punteggio (PASS tiers, pesi) Sì. RFC → TSC vota &rr; PR
Cambiamento di rottura a schemi di controllo o ID Sì. RFC → TSC vota &rr; PR
Proposta del gruppo di lavoro Sì. RFC → lazy consenso → charter pubblicato
Governance o cambiamenti di ruolo Sì. RFC → supermajority TSC
Nuovo controllo (non rotante, additivo) Consigliato PR con link di discussione · consenso pigro
Docs wording, typo fixs, traduzioni No. PR solo
Contenuto del sito web, post del blog No. PR solo
Ciclo di vita

Flusso di stato RFC

Ogni RFC segue lo stesso percorso documentato — dal primo progetto alla decisione chiusa.

Progetto
Autore scrive la proposta in GitHub Discussioni
aperto
Minimo 5 giorni lavorativi aperti per il commento della comunità
accettato
TSC voto o consenso pigro — documentato pubblicamente
implementato
PR fuso, ingresso changelog aggiunto, RFC chiuso
Risultati alternativi: respinto(non accettato dopo la recensione)  ·  ritirato(pulito dall'autore). Entrambi sono documentati con motivi.
Scrivere un RFC

Come scrivere una buona RFC

Tre cose che fanno la differenza tra un RFC che si muove velocemente e uno che si blocca.

Dichiarare il problema, non la soluzione

Inizia con ciò che è rotto o mancante — non con quello che vuoi costruire. I recensori devono concordare che il problema è reale prima che possano valutare la soluzione proposta. Incorniciare il "perché" prima del "cosa".

Mostra trade-off e alternative

Una forte RFC spiega cos'altro è stato considerato e perché è stato respinto. Questo salva i cicli di revisione e dà il contesto futuro dei manutentori quando l'autore originale ha acceso.

Essere specifici per l'impatto

Chi è interessato? Quali repository, file o contratti pubblici cambiano? Più chiara la portata, più veloce la comunità può dare feedback utili e un manutentore può prendere una decisione.

Pronti a modellare WAF++?

Ogni decisione inizia con una conversazione.

Scegli un RFC aperto, condividi la tua prospettiva, o apri una nuova. Il quadro è costruito in pubblico e ogni voce conta.