菜单
Phase 1.5/2.5 of disciplined development. Evaluates document quality using the KLS (Krogstie-Lindland-Sindre) 6-dimension framework. Produces structured ratings, identifies gaps, suggests specific revisions, and blocks phase transitions when quality is below threshold. Applies to Phase 1 research docs and Phase 2 design docs.
| name | disciplined-quality-evaluation |
| description | Phase 1.5/2.5 of disciplined development. Evaluates document quality using the KLS (Krogstie-Lindland-Sindre) 6-dimension framework. Produces structured ratings, identifies gaps, suggests specific revisions, and blocks phase transitions when quality is below threshold. Applies to Phase 1 research docs and Phase 2 design docs. |
| license | Apache-2.0 |
You evaluate Research Documents (Phase 1) and Implementation Plans (Phase 2) using the KLS framework before they proceed to next phases.
The Krogstie-Lindland-Sindre framework evaluates document quality across six dimensions:
| Dimension | Question | Evaluation Focus |
|---|---|---|
| Physical | Is it readable, well-formatted, accessible? | Formatting, structure, accessibility |
| Empirical | Can it be understood by intended audience? | Clarity, terminology, examples |
| Syntactic | Is it internally consistent and well-structured? | Consistency, organization, completeness |
| Semantic | Does it accurately represent the domain? | Accuracy, correctness, domain fit |
| Pragmatic | Does it enable the intended decisions/actions? | Actionability, usefulness, guidance |
| Social | Do stakeholders agree with its content? | Consensus, review status, approvals |
| Score | Meaning | Characteristics |
|---|---|---|
| 1 | Poor | Major issues, blocks understanding or use |
| 2 | Below Standard | Significant gaps, needs substantial work |
| 3 | Adequate | Meets minimum bar, minor improvements needed |
| 4 | Good | Clear, useful, few issues |
| 5 | Excellent | Exemplary, no issues, could be a template |
minimum_dimension_score: 3 # No dimension below 3
minimum_average_score: 3.5 # Average across all dimensions
blocking: true # Fail blocks phase transition
In addition to KLS dimensions, evaluate essentialism alignment:
| Check | Question | Evaluation |
|---|---|---|
| Vital Few Focus | Does this focus on 5 or fewer essential items? | Count major scope items |
| Eliminated Noise | Is there a clear "out of scope" section? | Check for elimination documentation |
| Effortless Path | Is the proposed path the simplest possible? | Look for over-engineering |
| 90% Rule | Does each item pass the "HELL YES" test? | Challenge marginal inclusions |
For each dimension:
Apply GO/NO-GO rules to determine status.
# Quality Evaluation: [Document Name]
**Document Type**: Research Document / Implementation Plan
**Phase Transition**: Phase X -> Phase Y
**Status**: PASS / CONDITIONAL PASS / FAIL
**Evaluator**: [Name]
**Date**: [YYYY-MM-DD]
## Executive Summary
[2-3 sentences on overall quality and decision]
## KLS Dimension Scores
| Dimension | Score | Justification | Required Fix |
|-----------|-------|---------------|--------------|
| Physical | X/5 | [Evidence-based reasoning] | [If <3, specific fix] |
| Empirical | X/5 | [Evidence-based reasoning] | [If <3, specific fix] |
| Syntactic | X/5 | [Evidence-based reasoning] | [If <3, specific fix] |
| Semantic | X/5 | [Evidence-based reasoning] | [If <3, specific fix] |
| Pragmatic | X/5 | [Evidence-based reasoning] | [If <3, specific fix] |
| Social | X/5 | [Evidence-based reasoning] | [If <3, specific fix] |
**Average Score**: X.X/5
**Minimum Score**: X/5 ([dimension])
## Essentialism Evaluation
| Check | Status | Evidence |
|-------|--------|----------|
| Vital Few Focus (<=5 items) | Pass/Fail | [Count and list] |
| Eliminated Noise | Pass/Fail | [Out of scope section exists?] |
| Effortless Path | Pass/Fail | [Simplicity assessment] |
| 90% Rule | Pass/Fail | [Marginal items identified] |
## Decision
**GO/NO-GO**: [PASS / CONDITIONAL PASS / FAIL]
**Rationale**: [Brief explanation of decision]
### Required Actions (if FAIL)
1. [Specific, actionable fix]
2. [Specific, actionable fix]
### Recommended Actions (if CONDITIONAL PASS)
1. [Improvement suggestion]
2. [Improvement suggestion]
### Commendations (if PASS)
- [What was done well]
## Re-Evaluation
After fixes are applied:
- [ ] All required actions addressed
- [ ] Re-score affected dimensions
- [ ] Update decision status
disciplined-research -> disciplined-quality-evaluation -> disciplined-design
disciplined-design -> disciplined-quality-evaluation -> disciplined-implementation
The quality-gate skill delegates document quality evaluation to this skill when reviewing Research or Design documents.
Secure secret management using 1Password CLI. Detect plaintext secrets in files and codebases, convert environment files to 1Password templates, inject secrets securely using op inject, and audit codebases for security compliance.
Comprehensive Caddy web server management across multiple environments. Handles multi-server operations, zero-downtime deployments, secret management with 1Password, custom builds with plugins, and systemd service management.
Generates Rust code for GPUI desktop UI components following Zed editor patterns. Use when building desktop applications with gpui crate, creating themed UI components, implementing autocomplete/completions, building command palettes, or working with the gpui-component library. Covers RenderOnce components, Entity state management, theming with ActiveTheme, and Zed-style UI patterns.
MD-Book documentation generator skill. Use when working with MD-Book, a modern mdbook replacement for generating HTML documentation from Markdown files. Supports syntax highlighting, live reload, Pagefind search, and Tera templates.
Phase 2 of disciplined development. Creates implementation plans based on approved research. Specifies file changes, function signatures, test strategy, and step sequence. Requires human approval before implementation.
Phase 3 of disciplined development. Executes approved implementation plans step by step. Each step includes tests, follows the design exactly, and produces reviewable commits.