Skip to content

docs: add semantic effectiveness bar#25

Draft
ramsani wants to merge 1 commit into
mainfrom
issue-22-effectiveness-bar
Draft

docs: add semantic effectiveness bar#25
ramsani wants to merge 1 commit into
mainfrom
issue-22-effectiveness-bar

Conversation

@ramsani
Copy link
Copy Markdown
Owner

@ramsani ramsani commented May 21, 2026

Closes #22

Objective

Add a semantic Effectiveness Bar above the structural Quality Bar so generated HTML is judged by whether it helps the user decide, act, continue, or reuse context.

Scope

  • Adds docs/EFFECTIVENESS_BAR.md.
  • References it from make, pick, and audit commands.
  • Clarifies in docs/QUALITY_BAR.md that Quality Bar is the structural floor, not proof of effectiveness.

No-scope

  • No deploy, VPS, secrets, DB, infra, external dependencies, CSS redesign, Mermaid, charts, or sharing changes.

Validation

  • scripts/validate-commands.sh passed.
  • scripts/validate-golden-artifacts.sh passed.

Rollback

Revert this PR to return to docs/QUALITY_BAR.md as the only explicit delivery gate.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[P1] Add semantic Effectiveness Bar for decision-ready HTML artifacts

1 participant