Zensical KB Site¶
Markdown-authored documentation or knowledge-base sites built with Zensical and published as static docs.
Charter status¶
| Charter status | Value |
|---|---|
| Maturity | Draft charter |
| What this state means | Scope, composition, detection signals, and the VCQA-owned rule surface are recorded, but there are no judgeable candidate rules yet. Useful for planning, not for review. |
| Full rubric | Not authored yet. This page is a charter, not a judgeable standard. |
| Reference implementation | vibecodeqa/ref-zensical-kb-site (experimental) — see Reference implementation below. |
| Blocking promotion | Scope, composition, detection signals, and rule surface are recorded, but no numbered candidate rules exist. This repository's own docs site is the in-house consumer, and ref-zensical-kb-site is now built and cataloged as experimental with a self-reported score and a green CI run (#17). Blocking a candidate rubric: the rule surface has to become numbered rules with severity, evidence, and an exception policy, and the reference repo's KB-quality model is the obvious input for authoring them. |
Maturity states are defined in Standards Authoring.
Metadata lives in standards/registry.json.
Full rubric¶
No full versioned rubric has been authored yet.
Reference implementation¶
| Score evidence | Value |
|---|---|
| Repository | vibecodeqa/ref-zensical-kb-site (experimental) |
| VCQA report | B 88/100 |
| Verification | self-reported |
| Assessed commit | 7b3f489 |
| Assessed on | 2026-08-09 |
| CI run | success (2026-08-08) |
| Independent assessment | None published yet. The score above is the reference repo's own claim, not third-party proof. |
| Catalog entry last verified | 2026-08-09 |
Scope¶
Markdown-authored documentation or knowledge-base sites built with Zensical and published as static docs.
Not in scope¶
- marketing pages authored directly in HTML
- unpublished internal notes
- generic writing style guides
Composes¶
VCQA-owned rule surface¶
- Markdown source is the source of truth.
- generated site is ignored.
- published URLs are stable.
- source references are tracked.
- docs drift checks where mirrors exist.
Detection signals¶
zensical.toml- Markdown docs tree
- docs build/deploy workflow
Combination-born guidelines¶
- Markdown source is the source of truth; generated
site/output is not manually edited. - External standards and machine-readable registries need stable public URLs.
- Navigation must expose authored standards and planned charters without guessed URLs.
Benefits¶
- vibecodeqa/docs.
- vibecodeqa/standards.
- Cloudflare SaaS example docs.