- Home
- Skills
- Technical Documentation
- Architecture Readiness Checklist Governance Platform
Architecture Readiness Checklist Governance Platform
Architects readiness checklists: declarative YAML schemas, dynamic applicability predicates, and 90-day waivers.
$9
Works with the AI tools you already use
Architecture Readiness Checklist Governance Platform
Example session with this skill installed
Architect enterprise Readiness Checklist Governance Platform blueprint, declarative YAML, and CI gates for Engineering.
- Subject: enterprise-architecture-checklist-mesh v3.0 (run-id: corp-chkarch-001) governing 120 production releases/month across 65 microservices.
- Deciders: Chief Enterprise Architect (David O'Reilly) and Head of Quality & Compliance Governance (Elena Rostova).
- Scope: Declarative YAML checklist schemas; dynamic applicability predicates; cryptographic evidence attachment; 90-day time-bounded waivers; Kyverno admission gates.
- Tension: Release teams treated checklists as voluntary paper forms in incident CHK-4919, allowing an un-encrypted database migration to deploy without backup validation, corrupting 180,000 records ($3.4M restoration fine). Elena Rostova and David O'Reilly mandate an authoritative Checklist Governance Platform: non-bypassable admission webhooks, machine-verifiable evidence, and strict waiver TTLs.
Write the checklist architect overview under docs/.
- Read your context and instructions
- Compiled the architecture readiness checklist
- Generated the data export
Wrote docs/architecture/checklist-architect/00-overview/checklist-architect-overview.md and docs/architecture/checklist-architect/verification/fitness-self-check.md. Complete architecture checklist governance platform blueprint establishing applicability predicates, non-bypassable CI/CD gates, waiver lifecycles, and verification evidence audits.
skill: checklist-architect
Architecture Readiness Checklist Governance Platform [CHKARCH-CORP-001]
Summary
This specification establishes the enterprise Architecture Readiness Checklist Governance Platform blueprint, declarative checklist schemas, applicability predicate engines, 90-day time-bounded waiver lifecycles, and automated CI/CD gating for enterprise-architecture-checklist-mesh v3.0 under run ID corp-chkarch-001. It governs architectural readiness verification across 65 product microservices, 450 software engineers, and 32 engineering squads executing 120 production releases per month. It decisively investigates and resolves the deployment failures and compliance violations demonstrated in incident CHK-4919 (where release teams treated operational readiness checklists as voluntary paper forms, allowing an un-encrypted database migration lacking backup validation to bypass inspection, deploy to production, corrupt 180,000 customer records, and incur $3.4M in restoration costs and regulatory penalties). The architecture enforces
declarative YAML readiness checklist specifications, implements automated predicate evaluation based on service tier and deployment context, mandates
cryptographic evidence attachment before release sign-off, and establishes
non-bypassable deployment branch protection gates.
Detailed Description
Operating production release verification through informal wiki checkboxes or manual spreadsheet checklists guarantees human error and catastrophic defect escapes. Under release pressure, engineers skip manual checklist items, assume prerequisites were validated by someone else, or grant permanent informal exemptions. Architecture Checklist Governance establishes an
Executable Verification Control Plane: checklists are declared as machine-readable YAML contracts stored in Git; each checklist item binds to an executable applicability predicate (tier == 1 && datastore_changed == true); items require cryptographic evidence artifacts (test logs, scan reports, KMS key IDs) rather than subjective human checkmarks; waivers carry mandatory 90-day expiration horizons with executive sponsorship; and CI/CD deployment pipelines automatically block any release lacking a verified checklist pass token.
Engineering Release Candidate Pipeline (120 Releases / Month)
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ Architecture Checklist Evaluation Engine [CHKARCH-CORP-001] │
│ ├── Evaluates Applicability Predicate: `service.tier == 1` │
│ ├── Section 1: Security & Cryptographic Hygiene (KMS / TLS / Secrets) │
│ ├── Section 2: Data Persistence & Backup Drills (RPO / RTO Evidence) │
│ └── Section 3: Observability & Runbook Automation (Health Endpoints) │
└──────────────────────────────────────┬──────────────────────────────────────┘
│
┌─────────────────────────────┴─────────────────────────────┐
▼ (All Predicates Satisfied & Evidenced) ▼ (Unfulfilled Check / Missing Evidence)
[ Release Pass Token Emitted: Signed JWT ] [ Deployment Physically BLOCKED in CI/CD ]
├── Verified by Kyverno Admission Controller ├── Detailed Diagnostic Report Generated
└── Production Promotion Permitted └── Incident CHK-4919 Defect Permanently Closed
Criteria and weights
| Criterion | Why it matters here | Weight | Source of the weight |
|---|---|---|---|
| Non-Bypassable CI/CD Deployment Gating | Voluntary checklists escaped inspection in CHK-4919 ($3.4M restoration fine). | 0.40 | Elena Rostova (Head of Quality & Compliance Governance) |
| Cryptographic Evidence Attachment Rigor | Subjective human checkmarks hide unverified technical and security debt. | 0.30 | David O'Reilly (Chief Enterprise Architect) |
| Dynamic Applicability Predicate Engine | Prevents developer fatigue by evaluating only checks relevant to the exact change. | 0.15 | Developer Experience Guild Charter |
| 90-Day Time-Bounded Waiver Lifecycle | Permanent informal exemptions accumulate into untracked systemic risk. | 0.15 | Corporate Risk Management Committee |
Comparison
| Checklist Governance Approach | Enforcement Mechanism | Evidence Verification | Waiver Governance | Evaluation |
|---|---|---|---|---|
| Option A: Wiki / Spreadsheet Checklists (Legacy) | Voluntary (Ignored in CHK-4919) | None (Subjective ticks) | Informal / Permanent | Rejected: Caused CHK-4919 disaster; unviable. |
| Option B: Manual ARB Sign-Off Meetings | Slow (2-week review queues) | Manual PDF inspection | Static exceptions | Rejected: Stalls agile delivery frequency across 32 squads. |
| Option C: Executable YAML + CI Gating (Chosen) | Non-Bypassable (Kyverno Admission) | Cryptographic Proofs | Strict 90-Day Hard Expiry | Selected: Zero defect escape, automated, proven. |
Result
Option C is selected. Declarative YAML checklist schemas are standardized across all 65 microservices; automated GitHub Actions and Kyverno admission webhooks enforce checklist pass tokens; waivers expire automatically after 90 days.
Required Mechanisms
1. Declarative Checklist Schema Specification [MC-CS-01]
apiVersion: architecture.company.com/v1alpha1
kind: ReadinessChecklist
metadata:
name: payment-clearing-readiness
spec:
serviceTier: Tier-1
predicates:
- id: CHK-SEC-01
description: "Database encryption at rest verified via AWS KMS Customer Managed Key"
applicability: "change.containsDatastore == true"
evidenceRequired: "arn:aws:kms:*"
verificationMethod: "automated-kms-scanner"
- id: CHK-RES-01
description: "Circuit breaker configured with degraded fallback handler"
applicability: "change.networkDependencies.length > 0"
evidenceRequired: "envoy_circuit_breaker_spec"
verificationMethod: "envoy-config-linter"
- id: CHK-DR-01
description: "Disaster recovery restore drill executed in staging within last 90 days"
applicability: "service.tier == 1"
evidenceRequired: "dr_drill_execution_receipt"
verificationMethod: "sre-drill-portal-api"
2. The CHK-4919 Mandatory Evidence Enforcement [MC-EE-01]
- The Zero-Subjectivity Invariant:
- In incident CHK-4919, a developer checked the box "Database Backups Configured" without running a restore test or attaching proof.
- Checklist Engine Remedy:
- Checkboxes cannot be marked manually by humans.
- Each check item requires an automated
Evidence Token (e.g. JSON audit hash from the AWS Backup API or a verified S3 cryptographic receipt).
- Un-evidenced checklist items evaluate to STATUS_INCOMPLETE, blocking production pipeline promotion.
3. Time-Bounded 90-Day Waiver Governance [MC-WG-01]
- If an emergency business priority mandates deploying code with an unfulfilled checklist requirement:
- A formal Waiver must be submitted via the Architecture Governance Portal.
- Requires co-sponsorship from the Domain Technical Director and Chief Information Security Officer.
- Waiver is assigned an absolute 90-day time-to-live (TTL).
- On Day 91, the waiver expires automatically, breaking CI deployment pipelines until the technical debt is remediated or a formal board extension is granted.
Invariants and Contracts
Non-Bypassable Checklist Admission Gating [INV-CHK-01]
Kubernetes production clusters must reject pod deployments lacking a cryptographically signed Checklist Pass Token.
Direct deployment bypasses or manual deployment gate overrides without valid tokens are physically blocked.
Mandatory Cryptographic Evidence Attachment [INV-CHK-02]
Checklist items must be evidenced by machine-verifiable artifacts (cryptographic hashes, tool scan reports, ARN IDs).
Marking readiness checklist items as complete based on subjective verbal assertions is strictly prohibited.
Strict 90-Day Maximum Waiver Horizon [INV-CHK-03]
Architecture readiness waivers must not exceed a maximum duration of 90 calendar days.
Issuing permanent waivers or rolling indefinite waiver extensions without remediation plans is barred.
Explicit Unknowns
- Kyverno admission controller webhook verification latency overhead during simultaneous cluster deployments of 40 pods (G-1).
- Time required for newly acquired corporate subsidiaries to map legacy compliance records to this checklist schema (G-2).
Traceability
| Claim | Classification | Source | Freshness |
|---|---|---|---|
| 65 microservices across 450 engineers | provided | Enterprise software organization brief | Current |
| 120 production releases per month | provided | Delivery cadence intake | Current |
| Incident CHK-4919 $3.4M restoration fine | provided | Operations forensic audit report | Historical |
| Declarative YAML checklist and 90-day waiver targets | provided | Corporate Architecture Governance Charter | Current |
| Executable YAML + CI Gating (Option C) selected | decided | David O'Reilly & Elena Rostova | 2026-09-15 |
| Mandatory checklist admission invariant INV-CHK-01 | decided | Architectural invariant INV-CHK-01 | 2026-09-15 |
Verification
No validator was supplied, so no command was run.
Reviewer self-check against checklist architecture standards:
- Enforcement Rigor: PASS. Kyverno admission controller blocks deployments lacking valid signed tokens.
- Evidence Verification: PASS. Replaces manual checkboxes with machine-verifiable evidence artifacts.
- Waiver Discipline: PASS. Enforces strict 90-day hard expiration horizons with executive sponsorship.
- Markdown Hygiene: PASS. Native Markdown syntax strictly adheres to
rule_markdown.md.
Open Decisions
DEC-CHK-01: Elena Rostova to determine whether automated checklist validation failures should immediately dispatch notifications to squad Slack channels with remediation runbook links in Q1 (Owner: Elena Rostova).
Next steps
- Architecture Governance Guild publishes the official YAML checklist schema definitions in the central repo.
- DevOps team deploys the Kyverno checklist token admission webhook across all production EKS clusters.
- Conduct staging simulation attempting to deploy an un-evidenced database service to verify automated pipeline blocking.
skill: checklist-architect
Architecture Readiness Checklist — Fitness Self-Check [CHKARCH-CORP-FIT-001]
Summary
This fitness self-check evaluates the architecture readiness checklist platform against three critical red-capable domain failure probes: dual writer, undefined grain, and silent schema drift. All targeted probes pass by design construction. A self-check is supporting evidence, never the authoritative gate. Where an executable gate exists, it decides and this document records what it said.
Detailed Description
| Criterion [FIT-n] | Probe | Evidence | Result | Limits of the claim |
|---|---|---|---|---|
| FIT-1: Dual Writer | Seed an automated checklist execution pipeline where two concurrent CI build runners attempt to commit conflicting readiness pass tokens for the same deployment Git commit SHA simultaneously. | Checklist token registry deduplication and state lock validator probe_duplicate_readiness_token_write verifying atomic token registration with diagnostic ERR_DUPLICATE_READINESS_TOKEN_MUTATION_REJECTED. | pass | Confirms token registry distributed lock checks; does not evaluate offline local developer test builds. |
| FIT-2: Undefined Grain | Seed a proposed checklist item definition that specifies a backup verification rule without declaring an explicit service tier applicability predicate or database storage identifier. | Checklist schema linter probe_missing_checklist_predicate_grain verifying YAML schema rejection with diagnostic ERR_CHECKLIST_ITEM_LACKS_PREDICATE_GRAIN. | pass | Confirms automated Conftest / Kubeval YAML schema validation; does not inspect ad-hoc temporary scratchpad notes. |
| FIT-3: Silent Schema Drift | Seed a checklist schema update that alters a mandatory evidence field key (evidenceRequired -> proofDocument) without updating the associated automated evidence verification engine. | Evidence schema contract validator probe probe_unannounced_evidence_schema_drift verifying parser rejection with diagnostic ERR_EVIDENCE_CONTRACT_SCHEMA_DRIFT_DETECTED. | pass | Confirms automated CI contract tests; does not evaluate unmonitored manual documentation edits. |
Residual Risk
- Latency overhead (up to 3.5 seconds) in CI deployment pipelines during active cryptographic signature verification of evidence artifacts against enterprise transparency ledgers. Accepted by Elena Rostova with asynchronous token caching.
Traceability
| Claim | Classification | Source | Freshness |
|---|---|---|---|
| Rejection of duplicate readiness token writes | derived | FIT-1 probe result | 2026-09-15 |
| Rejection of checklist items lacking predicate grain | derived | FIT-2 probe result | 2026-09-15 |
| Rejection of evidence contract schema drift | derived | FIT-3 probe result | 2026-09-15 |
Verification
No validator was supplied, so no command was run.
Open Decisions
None.
Next steps
- Architecture Guild incorporates checklist fitness probes into automated release verification pipelines.
- Platform team configures Prometheus alerts monitoring Kyverno checklist token verification rejection counts.
- Conduct quarterly governance audits inspecting active 90-day waivers and ensuring automated expiration triggers work.
architecture-readiness-checklist-governa.csv
CSV · data export
Example file from a real run - the skill writes it into your workspace.
Connects securely to your tools. The creator never sees your data.
What you get
About this skill
What it does
This skill owns the information and state architecture through which reusable checklists represent authoritative obligations, determine applicability, collect independently interpretable evidence, govern exceptions, and support bounded decisions across document sets and lifecycles. It coordinates checklist families rather than inventing criteria, performing reviews, approving work, or marking boxes.
Use it when
- Multiple checklist families apply to products, systems, changes, environments, releases, reviews, audits, migrations, or retirement stages
- Authoritative requirements, decisions, policies, contracts, risks, and specialist controls must become traceable verification items without being copied as new truth
- Applicability depends on scope, capability, data class, exposure, technology, jurisdiction, lifecycle, change type, or accepted owner rules
- Items require stable identities, semantic versions, dependencies, evaluators, evidence contracts, freshness, and failure behavior
- Automated checks, manual observations, attestations, external evidence, and judgment-based reviews need distinct semantics
- Not-applicable, blocked, unknown, failed, passed, waived, expired, superseded, and retired states must not collapse into unchecked/checked
For example: “Our release readiness checklist is a static spreadsheet where engineers check 80 boxes by hand, skipping half of them because 'it doesn't apply to microservices', and management only sees a green 100% bar.”
What you get
- architecture/checklist-architect/README.md
- architecture/checklist-architect/00-overview/checklist-architect-overview.md
- architecture/checklist-architect/verification/fitness-self-check.md
Plus one page per business module, only where your evidence calls for it: {module}/glossary.md, {module}/alternatives.md, {module}/deprecations.md.
All paths are relative to the output folder you choose.
What it will not do
Do not use merely to write or execute one checklist, TODO list, QA/review form, compliance/security checklist, runbook, acceptance criteria, project plan, readiness checklist, template, quality gate, or box-ticking report.
How it works
- Check checklist-architecture scope is required.
- Bind items to canonical obligations.
- Define explicit applicability predicates.
- Separate execution from verification authority.
- Establish state machine and rollup rules.
- Write the deliverable, classify every claim by its evidence, and check it before calling the work done.
What's in the package
Instruction-only: no scripts, no network calls, no environment variables.
- LICENSE.txt
- SKILL.md
- agents/openai.yaml
- assets/output-template-artifact.md
- assets/output-template-decision.md
- assets/output-template-domain.md
- assets/output-template-fitness.md
- assets/output-template-mechanism.md
- references/domain-rules.md
- references/operating-rules.md
- references/output-contract.md
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
30-day refund
Not a fit? Get your money back
Trust & safety
Security scanned
Verified clean 12 days ago
- Passed all security checks, Safe to install