Governance · Transparent by default

RFC Tracker

Every significant change to WAF++ starts with a public Request for Comments. This page tracks every RFC — from first draft to merge — so every decision stays traceable.

14 implemented 19 open for review 2 drafts
35
Total RFCs
19
Open for review
2
Drafts
14
Implemented
0
Accepted
0
Rejected
Proposals

All Requests for Comments

Filter by status, read the summaries, and follow the linked discussions and pull requests.

WAF++ Framework

RFC-0001 Initial 7-pillar framework structure
implemented framework

Establishes the core seven-pillar model as the foundational structure of WAF++, covering Security, Reliability, Performance Efficiency, Cost Optimisation, Operational Excellence, Sustainability, and Developer Experience. Extended to eight pillars by RFC-0012.

Author:sascha-lewandowski Opened: 2025-12-05Decided: 2025-12-05Implemented: 2025-12-05PR: #1
RFC-0002 Public 2026 roadmap and milestone planning
implemented governance

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

Author:sascha-lewandowski Opened: 2025-12-06Decided: 2025-12-06Implemented: 2025-12-06PR: #2
RFC-0003 Pillar descriptions and key questions — 7 pillars
implemented framework

Adds the initial content definition for each of the 7 pillars: scope, rationale, and key assessment questions. Serves as the baseline for the controls library and was later extended to cover the 8th Agentic pillar (RFC-0012).

Author:sascha-lewandowski Opened: 2025-12-07Decided: 2025-12-07Implemented: 2025-12-07PR: #3
RFC-0004 Documentation migration to AsciiDoc / Antora
implemented docs

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

Author:t1murl Opened: 2026-02-20Decided: 2026-02-26Implemented: 2026-02-26PR: #4
RFC-0005 Contribution metadata: CONTRIBUTING, CODE_OF_CONDUCT, SECURITY
implemented governance

Adds the standard open-source health files to the framework repository: contribution guidelines, code of conduct (based on Contributor Covenant v2.1), and security policy.

Author:sascha-lewandowski Opened: 2026-02-06Decided: 2026-02-08Implemented: 2026-02-08PR: #6
RFC-0006 Sovereign pillar (Pillar 7) — initial controls
implemented framework

Introduces the Sovereign pillar as the 7th pillar of WAF++, covering data sovereignty, compliance, and jurisdictional control. Ships with 10 initial controls (WAF-SOV-010 through WAF-SOV-100).

Author:sascha-lewandowski Opened: 2026-02-14Decided: 2026-03-04Implemented: 2026-03-04
RFC-0007 Governance refactor: modular best practices, case studies and navigation
implemented framework

Restructures the Governance pillar (Pillar 7) into modular best-practice pages, adds case-study content, and updates the Antora navigation to improve discoverability and readability.

Author:sascha-lewandowski Opened: 2026-02-24Decided: 2026-03-04Implemented: 2026-03-04PR: #10
RFC-0008 Controls schema v1 — machine-readable YAML specification
implemented tooling

Defines a formal schema for WAF++ controls YAML files, enabling consistent validation, tooling integration, and third-party consumption of the 83+ controls library. Shipped as part of the v1.0 release.

Author:sascha-lewandowski Opened: 2026-03-10Decided: 2026-05-12Implemented: 2026-05-12
RFC-0009 PASS scoring model — formal specification for v1.0
implemented framework

Formalises the PASS scoring model as a normative specification: tier definitions, calculation rules, aggregation logic, and versioning contract. Required for and shipped with the WAFPass CLI / Server v1.0.0 release.

Author:t1murl Opened: 2026-03-08Decided: 2026-05-12Implemented: 2026-05-12
RFC-0010 Assessment tooling — CLI and scorecard approach
implemented tooling

Defines the approach for official WAF++ assessment tooling: the WAFPass CLI, server, dashboard, and web scorecard that consume the controls library and produce a PASS score report. Shipped with WAFPass v1.0.0 and extended in v1.1.0.

Author:sascha-lewandowski Opened: 2026-03-11Decided: 2026-05-12Implemented: 2026-05-12
RFC-0011 CI/CD pipeline for framework and tooling repositories
implemented tooling

Introduces automated checks and release workflows for the framework, pass, wafpass-server, and wafpass-dashboard repositories: Antora build validation, controls YAML linting, release automation, and link checking on every pull request.

Author:t1murl Opened: 2026-03-11Decided: 2026-03-22Implemented: 2026-03-22
RFC-0012 Agentic pillar as the 8th pillar
implemented framework

Adds the Agentic pillar (WAF-AGN) as the 8th pillar of WAF++, covering autonomous AI agent governance. Ships with 10 initial controls (WAF-AGN-010 through WAF-AGN-100), regulatory mappings, and English and German documentation. Brings the framework to 8 pillars and 83+ controls.

Author:sascha-lewandowski Opened: 2026-07-01Decided: 2026-07-05Implemented: 2026-07-05PR: #19
RFC-0015 Website radical redesign — apply dark-first theme to all public pages
open docs

Applies the radical dark-first design system to the remaining public pages (RFC tracker, team, roles, about, press, install) so the whole site uses one consistent visual language and accessibility patterns.

Author:sascha-lewandowski Opened: 2026-07-06Discussion: GitHub →
RFC-0016 Control-level remediation playbooks
draft framework

Standardises machine- and human-readable remediation guidance for every WAF++ control so operators can act on findings directly from a PASS report or dashboard.

Author:sascha-lewandowski Opened: 2026-07-08
RFC-0017 Multi-cloud provider expansion beyond AWS and SINA Cloud
draft tooling

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-08
GH-framework-26 RFC: Qualitätssicherung
open docs

- CI-Check für tote xrefs - CI-Check für unregistrierte nav.adoc - Linter für Control-Schema-Konsistenz (YAML ↔ .adoc ↔ Nav)

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-25 RFC: Sovereign & Resources ausbauen
open docs

- Sovereign-Definition/Scope/Principles auf Peer-Level erweitern - Sovereign-Evidence-Matrix - resources/index.adoc und wording/index.adoc als echte Übersicht/Glossar

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-23 RFC: Agentic-Säule vollenden
open docs

- maturity.adoc anlegen - evidence.adoc auf Security-Vorbild erweitern - glossary.adoc vervollständigen - alle agent-design/* und best-practices/* mit Beispielen ausschreiben

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-22 RFC: Navigation & Links konsolidieren
open docs

WIP - Homepage + pillars/index.adoc auf einheitliche Modul-Links umstellen - 64 relative ../-xrefs in modulpräfix-xrefs wandeln - Markdown-Links in bp-runbooks.adoc bereinigen

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-21 RFC: Antora-Struktur finalisieren
open docs

WIP - antora.yml: alle 10 Nav-Dateien registrieren, start_page setzen - pillar-security/nav.adoc anlegen - README.md + AGENTS.md auf 8-Modul-Layout aktualisieren - Entscheidung: efficiancy umbenennen ja/nein

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-24 RFC: Controls-Katalog korrigieren und erweitern
open docs

- 8 Säulen, korrekte Nummerierung - Agentic aufnehmen - WAF-COST-001 entweder in 010 umbenennen oder offiziell als “Pre-010” etablieren - control-schema.adoc auf AGN erweitern

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →

WAF++ Framework — Open for review

RFC-0015 Website radical redesign — apply dark-first theme to all public pages
open docs

Applies the radical dark-first design system to the remaining public pages (RFC tracker, team, roles, about, press, install) so the whole site uses one consistent visual language and accessibility patterns.

Author:sascha-lewandowski Opened: 2026-07-06Discussion: GitHub →
GH-framework-26 RFC: Qualitätssicherung
open docs

- CI-Check für tote xrefs - CI-Check für unregistrierte nav.adoc - Linter für Control-Schema-Konsistenz (YAML ↔ .adoc ↔ Nav)

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-25 RFC: Sovereign & Resources ausbauen
open docs

- Sovereign-Definition/Scope/Principles auf Peer-Level erweitern - Sovereign-Evidence-Matrix - resources/index.adoc und wording/index.adoc als echte Übersicht/Glossar

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-23 RFC: Agentic-Säule vollenden
open docs

- maturity.adoc anlegen - evidence.adoc auf Security-Vorbild erweitern - glossary.adoc vervollständigen - alle agent-design/* und best-practices/* mit Beispielen ausschreiben

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-22 RFC: Navigation & Links konsolidieren
open docs

WIP - Homepage + pillars/index.adoc auf einheitliche Modul-Links umstellen - 64 relative ../-xrefs in modulpräfix-xrefs wandeln - Markdown-Links in bp-runbooks.adoc bereinigen

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-21 RFC: Antora-Struktur finalisieren
open docs

WIP - antora.yml: alle 10 Nav-Dateien registrieren, start_page setzen - pillar-security/nav.adoc anlegen - README.md + AGENTS.md auf 8-Modul-Layout aktualisieren - Entscheidung: efficiancy umbenennen ja/nein

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-24 RFC: Controls-Katalog korrigieren und erweitern
open docs

- 8 Säulen, korrekte Nummerierung - Agentic aufnehmen - WAF-COST-001 entweder in 010 umbenennen oder offiziell als “Pre-010” etablieren - control-schema.adoc auf AGN erweitern

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →

WAF++ Framework — Drafts

RFC-0016 Control-level remediation playbooks
draft framework

Standardises machine- and human-readable remediation guidance for every WAF++ control so operators can act on findings directly from a PASS report or dashboard.

Author:sascha-lewandowski Opened: 2026-07-08
RFC-0017 Multi-cloud provider expansion beyond AWS and SINA Cloud
draft tooling

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-08

WAF++ Framework — Decided / implemented

RFC-0001 Initial 7-pillar framework structure
implemented framework

Establishes the core seven-pillar model as the foundational structure of WAF++, covering Security, Reliability, Performance Efficiency, Cost Optimisation, Operational Excellence, Sustainability, and Developer Experience. Extended to eight pillars by RFC-0012.

Author:sascha-lewandowski Opened: 2025-12-05Decided: 2025-12-05Implemented: 2025-12-05PR: #1
RFC-0002 Public 2026 roadmap and milestone planning
implemented governance

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

Author:sascha-lewandowski Opened: 2025-12-06Decided: 2025-12-06Implemented: 2025-12-06PR: #2
RFC-0003 Pillar descriptions and key questions — 7 pillars
implemented framework

Adds the initial content definition for each of the 7 pillars: scope, rationale, and key assessment questions. Serves as the baseline for the controls library and was later extended to cover the 8th Agentic pillar (RFC-0012).

Author:sascha-lewandowski Opened: 2025-12-07Decided: 2025-12-07Implemented: 2025-12-07PR: #3
RFC-0004 Documentation migration to AsciiDoc / Antora
implemented docs

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

Author:t1murl Opened: 2026-02-20Decided: 2026-02-26Implemented: 2026-02-26PR: #4
RFC-0005 Contribution metadata: CONTRIBUTING, CODE_OF_CONDUCT, SECURITY
implemented governance

Adds the standard open-source health files to the framework repository: contribution guidelines, code of conduct (based on Contributor Covenant v2.1), and security policy.

Author:sascha-lewandowski Opened: 2026-02-06Decided: 2026-02-08Implemented: 2026-02-08PR: #6
RFC-0006 Sovereign pillar (Pillar 7) — initial controls
implemented framework

Introduces the Sovereign pillar as the 7th pillar of WAF++, covering data sovereignty, compliance, and jurisdictional control. Ships with 10 initial controls (WAF-SOV-010 through WAF-SOV-100).

Author:sascha-lewandowski Opened: 2026-02-14Decided: 2026-03-04Implemented: 2026-03-04
RFC-0007 Governance refactor: modular best practices, case studies and navigation
implemented framework

Restructures the Governance pillar (Pillar 7) into modular best-practice pages, adds case-study content, and updates the Antora navigation to improve discoverability and readability.

Author:sascha-lewandowski Opened: 2026-02-24Decided: 2026-03-04Implemented: 2026-03-04PR: #10
RFC-0008 Controls schema v1 — machine-readable YAML specification
implemented tooling

Defines a formal schema for WAF++ controls YAML files, enabling consistent validation, tooling integration, and third-party consumption of the 83+ controls library. Shipped as part of the v1.0 release.

Author:sascha-lewandowski Opened: 2026-03-10Decided: 2026-05-12Implemented: 2026-05-12
RFC-0009 PASS scoring model — formal specification for v1.0
implemented framework

Formalises the PASS scoring model as a normative specification: tier definitions, calculation rules, aggregation logic, and versioning contract. Required for and shipped with the WAFPass CLI / Server v1.0.0 release.

Author:t1murl Opened: 2026-03-08Decided: 2026-05-12Implemented: 2026-05-12
RFC-0010 Assessment tooling — CLI and scorecard approach
implemented tooling

Defines the approach for official WAF++ assessment tooling: the WAFPass CLI, server, dashboard, and web scorecard that consume the controls library and produce a PASS score report. Shipped with WAFPass v1.0.0 and extended in v1.1.0.

Author:sascha-lewandowski Opened: 2026-03-11Decided: 2026-05-12Implemented: 2026-05-12
RFC-0011 CI/CD pipeline for framework and tooling repositories
implemented tooling

Introduces automated checks and release workflows for the framework, pass, wafpass-server, and wafpass-dashboard repositories: Antora build validation, controls YAML linting, release automation, and link checking on every pull request.

Author:t1murl Opened: 2026-03-11Decided: 2026-03-22Implemented: 2026-03-22
RFC-0012 Agentic pillar as the 8th pillar
implemented framework

Adds the Agentic pillar (WAF-AGN) as the 8th pillar of WAF++, covering autonomous AI agent governance. Ships with 10 initial controls (WAF-AGN-010 through WAF-AGN-100), regulatory mappings, and English and German documentation. Brings the framework to 8 pillars and 83+ controls.

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

WAFPass

RFC-0013 WAFPass support for Pillar-8 Agentic
implemented tooling

Extends WAFPass CLI, server, and dashboard to evaluate the Agentic pillar controls (WAF-AGN-*) as part of a full PASS assessment. Merged ahead of the WAFPass v1.1.0 release.

Author:sascha-lewandowski Opened: 2026-05-20Decided: 2026-05-27Implemented: 2026-05-27PR: #28
RFC-0014 WAFPass CLI / Server / Dashboard v1.1.0 release
implemented tooling

Releases WAFPass CLI v1.1.0, WAFPass Server v1.1.0, and WAFPass Dashboard v1.1.0 with Pillar-8 Agentic support, detection fixes, and SINA Cloud region detection. Aligned with framework v1.1 and the 83+ controls library.

Author:sascha-lewandowski Opened: 2026-06-28Decided: 2026-07-05Implemented: 2026-07-05PR: #31
GH-pass-41 Feature Request: Comprehensive Test/Quality Coverage Implementation Plan
open tooling

📋 Context & Problem Statement The WAF++ PASS platform code and test coverage are highly fragmented across three distinct repositories: * pass (Python CLI / pytest): Contains ~150 unit tests, localized auto-fix tests, and a single golden-file E2E fixture, but…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-42 Feature Request: API Versioning and Backwards-Compatibility Strategy for WAF++ PASS
open tooling

Context and Goals The WAF++ PASS product is moving through an API maturity push. Several parallel efforts already exist or are planned: * Maturity enforcement: Achievements, leaderboard, project passports, and tier rules. * Action-oriented notifications:…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub → Commenters: lewandos
GH-pass-43 Feature Request: Source Snapshots — Ingestion Contract and Reliable Upload Path
open tooling

Context Dashboard local preview and auto-fix features rely on Run.source_snapshot, a JSONB map of relative IaC file paths to raw file contents. Today, this snapshot is only captured when the CLI is explicitly invoked with both --output json, --upload-source,…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-40 Feature Request: Dashboard UX Overhaul — Guided Onboarding, Role-Based Landing, and Progressive Disclosure
open tooling

📋 Context & Problem Statement The dashboard currently exposes 46 pages through a bloated, 700px-wide mega-menu in TopNavigation.tsx. The navigation model is highly fragmented; buildNavSections() is duplicated across Sidebar.tsx and MobileMenu.tsx, leading to…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-39 Feature Request: Implement Action-Oriented Notifications
open tooling

📋 Context & Problem Statement The dashboard currently features a NotificationBell and a dedicated NotificationsPage, but notifications are entirely passive—they only display text titles, messages, and categories with no trailing interactive…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub →
GH-pass-38 Feature Request: Implement Control Packs Marketplace
open tooling

📋 Context & Problem Statement The dashboard currently features a ControlsPacksPage and the server exposes /control-packs endpoints, but functionality is restricted to admin-only uploads and basic catalogue syncs[cite: 1]. Auditors have highlighted that the…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub → Commenters: lewandos
GH-pass-37 Feature Request: Implement Maturity-Tier Enforcement Policy Gates
open tooling

📋 Context & Problem Statement Currently, the maturity journey is purely a dashboard visualization and local settings concept. Auditors have flagged a critical gap: there are no policy gates tying maturity tiers to CI/CD pipeline behavior (e.g., preventing a…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub →

WAFPass — Open for review

GH-pass-41 Feature Request: Comprehensive Test/Quality Coverage Implementation Plan
open tooling

📋 Context & Problem Statement The WAF++ PASS platform code and test coverage are highly fragmented across three distinct repositories: * pass (Python CLI / pytest): Contains ~150 unit tests, localized auto-fix tests, and a single golden-file E2E fixture, but…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-42 Feature Request: API Versioning and Backwards-Compatibility Strategy for WAF++ PASS
open tooling

Context and Goals The WAF++ PASS product is moving through an API maturity push. Several parallel efforts already exist or are planned: * Maturity enforcement: Achievements, leaderboard, project passports, and tier rules. * Action-oriented notifications:…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub → Commenters: lewandos
GH-pass-43 Feature Request: Source Snapshots — Ingestion Contract and Reliable Upload Path
open tooling

Context Dashboard local preview and auto-fix features rely on Run.source_snapshot, a JSONB map of relative IaC file paths to raw file contents. Today, this snapshot is only captured when the CLI is explicitly invoked with both --output json, --upload-source,…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-40 Feature Request: Dashboard UX Overhaul — Guided Onboarding, Role-Based Landing, and Progressive Disclosure
open tooling

📋 Context & Problem Statement The dashboard currently exposes 46 pages through a bloated, 700px-wide mega-menu in TopNavigation.tsx. The navigation model is highly fragmented; buildNavSections() is duplicated across Sidebar.tsx and MobileMenu.tsx, leading to…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-39 Feature Request: Implement Action-Oriented Notifications
open tooling

📋 Context & Problem Statement The dashboard currently features a NotificationBell and a dedicated NotificationsPage, but notifications are entirely passive—they only display text titles, messages, and categories with no trailing interactive…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub →
GH-pass-38 Feature Request: Implement Control Packs Marketplace
open tooling

📋 Context & Problem Statement The dashboard currently features a ControlsPacksPage and the server exposes /control-packs endpoints, but functionality is restricted to admin-only uploads and basic catalogue syncs[cite: 1]. Auditors have highlighted that the…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub → Commenters: lewandos
GH-pass-37 Feature Request: Implement Maturity-Tier Enforcement Policy Gates
open tooling

📋 Context & Problem Statement Currently, the maturity journey is purely a dashboard visualization and local settings concept. Auditors have flagged a critical gap: there are no policy gates tying maturity tiers to CI/CD pipeline behavior (e.g., preventing a…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub →
No drafts for WAFPass.

WAFPass — Decided / implemented

RFC-0013 WAFPass support for Pillar-8 Agentic
implemented tooling

Extends WAFPass CLI, server, and dashboard to evaluate the Agentic pillar controls (WAF-AGN-*) as part of a full PASS assessment. Merged ahead of the WAFPass v1.1.0 release.

Author:sascha-lewandowski Opened: 2026-05-20Decided: 2026-05-27Implemented: 2026-05-27PR: #28
RFC-0014 WAFPass CLI / Server / Dashboard v1.1.0 release
implemented tooling

Releases WAFPass CLI v1.1.0, WAFPass Server v1.1.0, and WAFPass Dashboard v1.1.0 with Pillar-8 Agentic support, detection fixes, and SINA Cloud region detection. Aligned with framework v1.1 and the 83+ controls library.

Author:sascha-lewandowski Opened: 2026-06-28Decided: 2026-07-05Implemented: 2026-07-05PR: #31
No RFCs for WAFPass Action.
No open RFCs for WAFPass Action.
No drafts for WAFPass Action.
No decided or implemented RFCs for WAFPass Action.

WAFPass MCP

GH-wafpass-mcp-7 RFC-5: Role-aware natural tool aliasing
open tooling

Problem: Tool names are long and auto-generated (api_auto_fix_classify_api_v1_auto_fix_classify_post). The LLM has to match long operation IDs, and the descriptions are now long because they embed role/category. Proposal: Allow curated aliases for the…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-4 RFC-2: MCP resource-level read-only endpoints
open tooling

Problem: The MCP only exposes tools. Users cannot ask "what controls failed in this run?" or "show me the source snapshot" without making multiple tool calls and stitching the JSON together. Proposal: Add MCP Resource definitions for run://{run_id},…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-6 RFC-4: Multi-step remediation plans (apply with rollback)
open tooling

Problem: Users can classify and preview patches, but applying them requires a separate auto-fix call with a filesystem path. There is no safe "apply this classify result to this run and record what changed." Proposal: Extend /api/v1/auto-fix/classify with an…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-5 RFC-3: Streaming/paginated tool results for large runs
open tooling

Problem: Runs with thousands of findings return huge JSON blobs. The current proxy loads everything into one TextContent block, which is slow and can hit MCP message size limits. Proposal: Add cursor-based pagination helpers to the bridge: - For list…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-3 RFC-1: Auto-fix default templates for WAFpass controls
open tooling

Problem: auto-fix/classify returns zero active patches for many controls because assertions like not_empty, attribute_exists, is_true have no registered default value. Proposal: Add a fix block to control YAMLs (or a central provider registry) that declares:…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →

WAFPass MCP — Open for review

GH-wafpass-mcp-7 RFC-5: Role-aware natural tool aliasing
open tooling

Problem: Tool names are long and auto-generated (api_auto_fix_classify_api_v1_auto_fix_classify_post). The LLM has to match long operation IDs, and the descriptions are now long because they embed role/category. Proposal: Allow curated aliases for the…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-4 RFC-2: MCP resource-level read-only endpoints
open tooling

Problem: The MCP only exposes tools. Users cannot ask "what controls failed in this run?" or "show me the source snapshot" without making multiple tool calls and stitching the JSON together. Proposal: Add MCP Resource definitions for run://{run_id},…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-6 RFC-4: Multi-step remediation plans (apply with rollback)
open tooling

Problem: Users can classify and preview patches, but applying them requires a separate auto-fix call with a filesystem path. There is no safe "apply this classify result to this run and record what changed." Proposal: Extend /api/v1/auto-fix/classify with an…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-5 RFC-3: Streaming/paginated tool results for large runs
open tooling

Problem: Runs with thousands of findings return huge JSON blobs. The current proxy loads everything into one TextContent block, which is slow and can hit MCP message size limits. Proposal: Add cursor-based pagination helpers to the bridge: - For list…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-3 RFC-1: Auto-fix default templates for WAFpass controls
open tooling

Problem: auto-fix/classify returns zero active patches for many controls because assertions like not_empty, attribute_exists, is_true have no registered default value. Proposal: Add a fix block to control YAMLs (or a central provider registry) that declares:…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
No drafts for WAFPass MCP.
No decided or implemented RFCs for WAFPass MCP.

WAF++ Framework

RFC-0001 Initial 7-pillar framework structure
implemented framework

Establishes the core seven-pillar model as the foundational structure of WAF++, covering Security, Reliability, Performance Efficiency, Cost Optimisation, Operational Excellence, Sustainability, and Developer Experience. Extended to eight pillars by RFC-0012.

Author:sascha-lewandowski Opened: 2025-12-05Decided: 2025-12-05Implemented: 2025-12-05PR: #1
RFC-0002 Public 2026 roadmap and milestone planning
implemented governance

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

Author:sascha-lewandowski Opened: 2025-12-06Decided: 2025-12-06Implemented: 2025-12-06PR: #2
RFC-0003 Pillar descriptions and key questions — 7 pillars
implemented framework

Adds the initial content definition for each of the 7 pillars: scope, rationale, and key assessment questions. Serves as the baseline for the controls library and was later extended to cover the 8th Agentic pillar (RFC-0012).

Author:sascha-lewandowski Opened: 2025-12-07Decided: 2025-12-07Implemented: 2025-12-07PR: #3
RFC-0004 Documentation migration to AsciiDoc / Antora
implemented docs

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

Author:t1murl Opened: 2026-02-20Decided: 2026-02-26Implemented: 2026-02-26PR: #4
RFC-0005 Contribution metadata: CONTRIBUTING, CODE_OF_CONDUCT, SECURITY
implemented governance

Adds the standard open-source health files to the framework repository: contribution guidelines, code of conduct (based on Contributor Covenant v2.1), and security policy.

Author:sascha-lewandowski Opened: 2026-02-06Decided: 2026-02-08Implemented: 2026-02-08PR: #6
RFC-0006 Sovereign pillar (Pillar 7) — initial controls
implemented framework

Introduces the Sovereign pillar as the 7th pillar of WAF++, covering data sovereignty, compliance, and jurisdictional control. Ships with 10 initial controls (WAF-SOV-010 through WAF-SOV-100).

Author:sascha-lewandowski Opened: 2026-02-14Decided: 2026-03-04Implemented: 2026-03-04
RFC-0007 Governance refactor: modular best practices, case studies and navigation
implemented framework

Restructures the Governance pillar (Pillar 7) into modular best-practice pages, adds case-study content, and updates the Antora navigation to improve discoverability and readability.

Author:sascha-lewandowski Opened: 2026-02-24Decided: 2026-03-04Implemented: 2026-03-04PR: #10
RFC-0008 Controls schema v1 — machine-readable YAML specification
implemented tooling

Defines a formal schema for WAF++ controls YAML files, enabling consistent validation, tooling integration, and third-party consumption of the 83+ controls library. Shipped as part of the v1.0 release.

Author:sascha-lewandowski Opened: 2026-03-10Decided: 2026-05-12Implemented: 2026-05-12
RFC-0009 PASS scoring model — formal specification for v1.0
implemented framework

Formalises the PASS scoring model as a normative specification: tier definitions, calculation rules, aggregation logic, and versioning contract. Required for and shipped with the WAFPass CLI / Server v1.0.0 release.

Author:t1murl Opened: 2026-03-08Decided: 2026-05-12Implemented: 2026-05-12
RFC-0010 Assessment tooling — CLI and scorecard approach
implemented tooling

Defines the approach for official WAF++ assessment tooling: the WAFPass CLI, server, dashboard, and web scorecard that consume the controls library and produce a PASS score report. Shipped with WAFPass v1.0.0 and extended in v1.1.0.

Author:sascha-lewandowski Opened: 2026-03-11Decided: 2026-05-12Implemented: 2026-05-12
RFC-0011 CI/CD pipeline for framework and tooling repositories
implemented tooling

Introduces automated checks and release workflows for the framework, pass, wafpass-server, and wafpass-dashboard repositories: Antora build validation, controls YAML linting, release automation, and link checking on every pull request.

Author:t1murl Opened: 2026-03-11Decided: 2026-03-22Implemented: 2026-03-22
RFC-0012 Agentic pillar as the 8th pillar
implemented framework

Adds the Agentic pillar (WAF-AGN) as the 8th pillar of WAF++, covering autonomous AI agent governance. Ships with 10 initial controls (WAF-AGN-010 through WAF-AGN-100), regulatory mappings, and English and German documentation. Brings the framework to 8 pillars and 83+ controls.

Author:sascha-lewandowski Opened: 2026-07-01Decided: 2026-07-05Implemented: 2026-07-05PR: #19
RFC-0015 Website radical redesign — apply dark-first theme to all public pages
open docs

Applies the radical dark-first design system to the remaining public pages (RFC tracker, team, roles, about, press, install) so the whole site uses one consistent visual language and accessibility patterns.

Author:sascha-lewandowski Opened: 2026-07-06Discussion: GitHub →
RFC-0016 Control-level remediation playbooks
draft framework

Standardises machine- and human-readable remediation guidance for every WAF++ control so operators can act on findings directly from a PASS report or dashboard.

Author:sascha-lewandowski Opened: 2026-07-08
RFC-0017 Multi-cloud provider expansion beyond AWS and SINA Cloud
draft tooling

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-08
GH-framework-26 RFC: Qualitätssicherung
open docs

- CI-Check für tote xrefs - CI-Check für unregistrierte nav.adoc - Linter für Control-Schema-Konsistenz (YAML ↔ .adoc ↔ Nav)

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-25 RFC: Sovereign & Resources ausbauen
open docs

- Sovereign-Definition/Scope/Principles auf Peer-Level erweitern - Sovereign-Evidence-Matrix - resources/index.adoc und wording/index.adoc als echte Übersicht/Glossar

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-23 RFC: Agentic-Säule vollenden
open docs

- maturity.adoc anlegen - evidence.adoc auf Security-Vorbild erweitern - glossary.adoc vervollständigen - alle agent-design/* und best-practices/* mit Beispielen ausschreiben

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-22 RFC: Navigation & Links konsolidieren
open docs

WIP - Homepage + pillars/index.adoc auf einheitliche Modul-Links umstellen - 64 relative ../-xrefs in modulpräfix-xrefs wandeln - Markdown-Links in bp-runbooks.adoc bereinigen

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-21 RFC: Antora-Struktur finalisieren
open docs

WIP - antora.yml: alle 10 Nav-Dateien registrieren, start_page setzen - pillar-security/nav.adoc anlegen - README.md + AGENTS.md auf 8-Modul-Layout aktualisieren - Entscheidung: efficiancy umbenennen ja/nein

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-24 RFC: Controls-Katalog korrigieren und erweitern
open docs

- 8 Säulen, korrekte Nummerierung - Agentic aufnehmen - WAF-COST-001 entweder in 010 umbenennen oder offiziell als “Pre-010” etablieren - control-schema.adoc auf AGN erweitern

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →

WAFPass

RFC-0013 WAFPass support for Pillar-8 Agentic
implemented tooling

Extends WAFPass CLI, server, and dashboard to evaluate the Agentic pillar controls (WAF-AGN-*) as part of a full PASS assessment. Merged ahead of the WAFPass v1.1.0 release.

Author:sascha-lewandowski Opened: 2026-05-20Decided: 2026-05-27Implemented: 2026-05-27PR: #28
RFC-0014 WAFPass CLI / Server / Dashboard v1.1.0 release
implemented tooling

Releases WAFPass CLI v1.1.0, WAFPass Server v1.1.0, and WAFPass Dashboard v1.1.0 with Pillar-8 Agentic support, detection fixes, and SINA Cloud region detection. Aligned with framework v1.1 and the 83+ controls library.

Author:sascha-lewandowski Opened: 2026-06-28Decided: 2026-07-05Implemented: 2026-07-05PR: #31
GH-pass-41 Feature Request: Comprehensive Test/Quality Coverage Implementation Plan
open tooling

📋 Context & Problem Statement The WAF++ PASS platform code and test coverage are highly fragmented across three distinct repositories: * pass (Python CLI / pytest): Contains ~150 unit tests, localized auto-fix tests, and a single golden-file E2E fixture, but…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-42 Feature Request: API Versioning and Backwards-Compatibility Strategy for WAF++ PASS
open tooling

Context and Goals The WAF++ PASS product is moving through an API maturity push. Several parallel efforts already exist or are planned: * Maturity enforcement: Achievements, leaderboard, project passports, and tier rules. * Action-oriented notifications:…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub → Commenters: lewandos
GH-pass-43 Feature Request: Source Snapshots — Ingestion Contract and Reliable Upload Path
open tooling

Context Dashboard local preview and auto-fix features rely on Run.source_snapshot, a JSONB map of relative IaC file paths to raw file contents. Today, this snapshot is only captured when the CLI is explicitly invoked with both --output json, --upload-source,…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-40 Feature Request: Dashboard UX Overhaul — Guided Onboarding, Role-Based Landing, and Progressive Disclosure
open tooling

📋 Context & Problem Statement The dashboard currently exposes 46 pages through a bloated, 700px-wide mega-menu in TopNavigation.tsx. The navigation model is highly fragmented; buildNavSections() is duplicated across Sidebar.tsx and MobileMenu.tsx, leading to…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-39 Feature Request: Implement Action-Oriented Notifications
open tooling

📋 Context & Problem Statement The dashboard currently features a NotificationBell and a dedicated NotificationsPage, but notifications are entirely passive—they only display text titles, messages, and categories with no trailing interactive…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub →
GH-pass-38 Feature Request: Implement Control Packs Marketplace
open tooling

📋 Context & Problem Statement The dashboard currently features a ControlsPacksPage and the server exposes /control-packs endpoints, but functionality is restricted to admin-only uploads and basic catalogue syncs[cite: 1]. Auditors have highlighted that the…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub → Commenters: lewandos
GH-pass-37 Feature Request: Implement Maturity-Tier Enforcement Policy Gates
open tooling

📋 Context & Problem Statement Currently, the maturity journey is purely a dashboard visualization and local settings concept. Auditors have flagged a critical gap: there are no policy gates tying maturity tiers to CI/CD pipeline behavior (e.g., preventing a…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub →

WAFPass Action

WAFPass MCP

GH-wafpass-mcp-7 RFC-5: Role-aware natural tool aliasing
open tooling

Problem: Tool names are long and auto-generated (api_auto_fix_classify_api_v1_auto_fix_classify_post). The LLM has to match long operation IDs, and the descriptions are now long because they embed role/category. Proposal: Allow curated aliases for the…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-4 RFC-2: MCP resource-level read-only endpoints
open tooling

Problem: The MCP only exposes tools. Users cannot ask "what controls failed in this run?" or "show me the source snapshot" without making multiple tool calls and stitching the JSON together. Proposal: Add MCP Resource definitions for run://{run_id},…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-6 RFC-4: Multi-step remediation plans (apply with rollback)
open tooling

Problem: Users can classify and preview patches, but applying them requires a separate auto-fix call with a filesystem path. There is no safe "apply this classify result to this run and record what changed." Proposal: Extend /api/v1/auto-fix/classify with an…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-5 RFC-3: Streaming/paginated tool results for large runs
open tooling

Problem: Runs with thousands of findings return huge JSON blobs. The current proxy loads everything into one TextContent block, which is slow and can hit MCP message size limits. Proposal: Add cursor-based pagination helpers to the bridge: - For list…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-3 RFC-1: Auto-fix default templates for WAFpass controls
open tooling

Problem: auto-fix/classify returns zero active patches for many controls because assertions like not_empty, attribute_exists, is_true have no registered default value. Proposal: Add a fix block to control YAMLs (or a central provider registry) that declares:…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →

WAF++ Framework

RFC-0015 Website radical redesign — apply dark-first theme to all public pages
open docs

Applies the radical dark-first design system to the remaining public pages (RFC tracker, team, roles, about, press, install) so the whole site uses one consistent visual language and accessibility patterns.

Author:sascha-lewandowski Opened: 2026-07-06Discussion: GitHub →
GH-framework-26 RFC: Qualitätssicherung
open docs

- CI-Check für tote xrefs - CI-Check für unregistrierte nav.adoc - Linter für Control-Schema-Konsistenz (YAML ↔ .adoc ↔ Nav)

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-25 RFC: Sovereign & Resources ausbauen
open docs

- Sovereign-Definition/Scope/Principles auf Peer-Level erweitern - Sovereign-Evidence-Matrix - resources/index.adoc und wording/index.adoc als echte Übersicht/Glossar

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-23 RFC: Agentic-Säule vollenden
open docs

- maturity.adoc anlegen - evidence.adoc auf Security-Vorbild erweitern - glossary.adoc vervollständigen - alle agent-design/* und best-practices/* mit Beispielen ausschreiben

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-22 RFC: Navigation & Links konsolidieren
open docs

WIP - Homepage + pillars/index.adoc auf einheitliche Modul-Links umstellen - 64 relative ../-xrefs in modulpräfix-xrefs wandeln - Markdown-Links in bp-runbooks.adoc bereinigen

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-21 RFC: Antora-Struktur finalisieren
open docs

WIP - antora.yml: alle 10 Nav-Dateien registrieren, start_page setzen - pillar-security/nav.adoc anlegen - README.md + AGENTS.md auf 8-Modul-Layout aktualisieren - Entscheidung: efficiancy umbenennen ja/nein

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-framework-24 RFC: Controls-Katalog korrigieren und erweitern
open docs

- 8 Säulen, korrekte Nummerierung - Agentic aufnehmen - WAF-COST-001 entweder in 010 umbenennen oder offiziell als “Pre-010” etablieren - control-schema.adoc auf AGN erweitern

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →

WAFPass MCP

GH-wafpass-mcp-7 RFC-5: Role-aware natural tool aliasing
open tooling

Problem: Tool names are long and auto-generated (api_auto_fix_classify_api_v1_auto_fix_classify_post). The LLM has to match long operation IDs, and the descriptions are now long because they embed role/category. Proposal: Allow curated aliases for the…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-4 RFC-2: MCP resource-level read-only endpoints
open tooling

Problem: The MCP only exposes tools. Users cannot ask "what controls failed in this run?" or "show me the source snapshot" without making multiple tool calls and stitching the JSON together. Proposal: Add MCP Resource definitions for run://{run_id},…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-6 RFC-4: Multi-step remediation plans (apply with rollback)
open tooling

Problem: Users can classify and preview patches, but applying them requires a separate auto-fix call with a filesystem path. There is no safe "apply this classify result to this run and record what changed." Proposal: Extend /api/v1/auto-fix/classify with an…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-5 RFC-3: Streaming/paginated tool results for large runs
open tooling

Problem: Runs with thousands of findings return huge JSON blobs. The current proxy loads everything into one TextContent block, which is slow and can hit MCP message size limits. Proposal: Add cursor-based pagination helpers to the bridge: - For list…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →
GH-wafpass-mcp-3 RFC-1: Auto-fix default templates for WAFpass controls
open tooling

Problem: auto-fix/classify returns zero active patches for many controls because assertions like not_empty, attribute_exists, is_true have no registered default value. Proposal: Add a fix block to control YAMLs (or a central provider registry) that declares:…

Author: lewandos lewandos Opened: 2026-08-14Discussion: GitHub →

WAFPass

GH-pass-41 Feature Request: Comprehensive Test/Quality Coverage Implementation Plan
open tooling

📋 Context & Problem Statement The WAF++ PASS platform code and test coverage are highly fragmented across three distinct repositories: * pass (Python CLI / pytest): Contains ~150 unit tests, localized auto-fix tests, and a single golden-file E2E fixture, but…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-42 Feature Request: API Versioning and Backwards-Compatibility Strategy for WAF++ PASS
open tooling

Context and Goals The WAF++ PASS product is moving through an API maturity push. Several parallel efforts already exist or are planned: * Maturity enforcement: Achievements, leaderboard, project passports, and tier rules. * Action-oriented notifications:…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub → Commenters: lewandos
GH-pass-43 Feature Request: Source Snapshots — Ingestion Contract and Reliable Upload Path
open tooling

Context Dashboard local preview and auto-fix features rely on Run.source_snapshot, a JSONB map of relative IaC file paths to raw file contents. Today, this snapshot is only captured when the CLI is explicitly invoked with both --output json, --upload-source,…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-40 Feature Request: Dashboard UX Overhaul — Guided Onboarding, Role-Based Landing, and Progressive Disclosure
open tooling

📋 Context & Problem Statement The dashboard currently exposes 46 pages through a bloated, 700px-wide mega-menu in TopNavigation.tsx. The navigation model is highly fragmented; buildNavSections() is duplicated across Sidebar.tsx and MobileMenu.tsx, leading to…

Author: lewandos lewandos Opened: 2026-07-18Discussion: GitHub →
GH-pass-39 Feature Request: Implement Action-Oriented Notifications
open tooling

📋 Context & Problem Statement The dashboard currently features a NotificationBell and a dedicated NotificationsPage, but notifications are entirely passive—they only display text titles, messages, and categories with no trailing interactive…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub →
GH-pass-38 Feature Request: Implement Control Packs Marketplace
open tooling

📋 Context & Problem Statement The dashboard currently features a ControlsPacksPage and the server exposes /control-packs endpoints, but functionality is restricted to admin-only uploads and basic catalogue syncs[cite: 1]. Auditors have highlighted that the…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub → Commenters: lewandos
GH-pass-37 Feature Request: Implement Maturity-Tier Enforcement Policy Gates
open tooling

📋 Context & Problem Statement Currently, the maturity journey is purely a dashboard visualization and local settings concept. Auditors have flagged a critical gap: there are no policy gates tying maturity tiers to CI/CD pipeline behavior (e.g., preventing a…

Author: lewandos lewandos Opened: 2026-07-17Discussion: GitHub →

WAF++ Framework

RFC-0016 Control-level remediation playbooks
draft framework

Standardises machine- and human-readable remediation guidance for every WAF++ control so operators can act on findings directly from a PASS report or dashboard.

Author:sascha-lewandowski Opened: 2026-07-08
RFC-0017 Multi-cloud provider expansion beyond AWS and SINA Cloud
draft tooling

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-08

WAF++ Framework

RFC-0001 Initial 7-pillar framework structure
implemented framework

Establishes the core seven-pillar model as the foundational structure of WAF++, covering Security, Reliability, Performance Efficiency, Cost Optimisation, Operational Excellence, Sustainability, and Developer Experience. Extended to eight pillars by RFC-0012.

Author:sascha-lewandowski Opened: 2025-12-05Decided: 2025-12-05Implemented: 2025-12-05PR: #1
RFC-0002 Public 2026 roadmap and milestone planning
implemented governance

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

Author:sascha-lewandowski Opened: 2025-12-06Decided: 2025-12-06Implemented: 2025-12-06PR: #2
RFC-0003 Pillar descriptions and key questions — 7 pillars
implemented framework

Adds the initial content definition for each of the 7 pillars: scope, rationale, and key assessment questions. Serves as the baseline for the controls library and was later extended to cover the 8th Agentic pillar (RFC-0012).

Author:sascha-lewandowski Opened: 2025-12-07Decided: 2025-12-07Implemented: 2025-12-07PR: #3
RFC-0004 Documentation migration to AsciiDoc / Antora
implemented docs

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

Author:t1murl Opened: 2026-02-20Decided: 2026-02-26Implemented: 2026-02-26PR: #4
RFC-0005 Contribution metadata: CONTRIBUTING, CODE_OF_CONDUCT, SECURITY
implemented governance

Adds the standard open-source health files to the framework repository: contribution guidelines, code of conduct (based on Contributor Covenant v2.1), and security policy.

Author:sascha-lewandowski Opened: 2026-02-06Decided: 2026-02-08Implemented: 2026-02-08PR: #6
RFC-0006 Sovereign pillar (Pillar 7) — initial controls
implemented framework

Introduces the Sovereign pillar as the 7th pillar of WAF++, covering data sovereignty, compliance, and jurisdictional control. Ships with 10 initial controls (WAF-SOV-010 through WAF-SOV-100).

Author:sascha-lewandowski Opened: 2026-02-14Decided: 2026-03-04Implemented: 2026-03-04
RFC-0007 Governance refactor: modular best practices, case studies and navigation
implemented framework

Restructures the Governance pillar (Pillar 7) into modular best-practice pages, adds case-study content, and updates the Antora navigation to improve discoverability and readability.

Author:sascha-lewandowski Opened: 2026-02-24Decided: 2026-03-04Implemented: 2026-03-04PR: #10
RFC-0008 Controls schema v1 — machine-readable YAML specification
implemented tooling

Defines a formal schema for WAF++ controls YAML files, enabling consistent validation, tooling integration, and third-party consumption of the 83+ controls library. Shipped as part of the v1.0 release.

Author:sascha-lewandowski Opened: 2026-03-10Decided: 2026-05-12Implemented: 2026-05-12
RFC-0009 PASS scoring model — formal specification for v1.0
implemented framework

Formalises the PASS scoring model as a normative specification: tier definitions, calculation rules, aggregation logic, and versioning contract. Required for and shipped with the WAFPass CLI / Server v1.0.0 release.

Author:t1murl Opened: 2026-03-08Decided: 2026-05-12Implemented: 2026-05-12
RFC-0010 Assessment tooling — CLI and scorecard approach
implemented tooling

Defines the approach for official WAF++ assessment tooling: the WAFPass CLI, server, dashboard, and web scorecard that consume the controls library and produce a PASS score report. Shipped with WAFPass v1.0.0 and extended in v1.1.0.

Author:sascha-lewandowski Opened: 2026-03-11Decided: 2026-05-12Implemented: 2026-05-12
RFC-0011 CI/CD pipeline for framework and tooling repositories
implemented tooling

Introduces automated checks and release workflows for the framework, pass, wafpass-server, and wafpass-dashboard repositories: Antora build validation, controls YAML linting, release automation, and link checking on every pull request.

Author:t1murl Opened: 2026-03-11Decided: 2026-03-22Implemented: 2026-03-22
RFC-0012 Agentic pillar as the 8th pillar
implemented framework

Adds the Agentic pillar (WAF-AGN) as the 8th pillar of WAF++, covering autonomous AI agent governance. Ships with 10 initial controls (WAF-AGN-010 through WAF-AGN-100), regulatory mappings, and English and German documentation. Brings the framework to 8 pillars and 83+ controls.

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

WAFPass

RFC-0013 WAFPass support for Pillar-8 Agentic
implemented tooling

Extends WAFPass CLI, server, and dashboard to evaluate the Agentic pillar controls (WAF-AGN-*) as part of a full PASS assessment. Merged ahead of the WAFPass v1.1.0 release.

Author:sascha-lewandowski Opened: 2026-05-20Decided: 2026-05-27Implemented: 2026-05-27PR: #28
RFC-0014 WAFPass CLI / Server / Dashboard v1.1.0 release
implemented tooling

Releases WAFPass CLI v1.1.0, WAFPass Server v1.1.0, and WAFPass Dashboard v1.1.0 with Pillar-8 Agentic support, detection fixes, and SINA Cloud region detection. Aligned with framework v1.1 and the 83+ controls library.

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

Want to propose a change?

Open a GitHub Discussion using the RFC template. The community reviews it, maintainers decide — everything is documented and traceable.

Process

What qualifies as an RFC?

Not every change needs an RFC — only significant ones. Use the table below to decide.

Change type RFC needed? Process
New pillar or removal of a pillar Yes RFC → TSC vote → PR
Scoring model changes (PASS tiers, weights) Yes RFC → TSC vote → PR
Breaking change to controls schema or IDs Yes RFC → TSC vote → PR
New Working Group proposal Yes RFC → lazy consensus → charter published
Governance or role changes Yes RFC → TSC supermajority
New control (non-breaking, additive) Recommended PR with discussion link · lazy consensus
Docs wording, typo fixes, translations No PR only
Website content, blog posts No PR only
Lifecycle

RFC status flow

Every RFC follows the same documented path — from first draft to closed decision.

draft
Author writes the proposal in GitHub Discussions
open
Minimum 5 business days open for community comment
accepted
TSC vote or lazy consensus — documented publicly
implemented
PR merged, changelog entry added, RFC closed
Alternative outcomes: rejected (not accepted after review)  ·  withdrawn (pulled by author). Both are documented with reasons.
Writing an RFC

How to write a good RFC

Three things that make the difference between an RFC that moves fast and one that stalls.

State the problem, not the solution

Start with what is broken or missing — not with what you want to build. Reviewers need to agree that the problem is real before they can evaluate your proposed solution. Frame the "why" before the "what".

Document trade-offs explicitly

Every decision has costs. Name them. What gets worse? What are the alternatives you considered? An RFC that acknowledges trade-offs earns trust faster than one that only sells the upside.

Link to evidence

Point to real examples — issues, incidents, prior discussions, or production patterns. Evidence turns opinions into traceable facts and dramatically shortens the review cycle.

Ready to contribute?

Start an RFC today.

Open a discussion on GitHub, follow the template, and let the process do the rest. No prior approval needed — just a clear problem statement.