Description

Detects workspaces that produce almost no markdown output, suggesting specs, plans, and documentation are skipped before coding.

When Triggered

{{count}} workspace(s) produce almost no markdown ({{extra.overallPct}}% of AI output). {{extra.totalCodeLoc}} LoC of code vs {{extra.totalMdLoc}} LoC of markdown. This suggests you skip writing specs, plans, and documentation before coding.

How to Improve

Adopt spec-driven development: ask Copilot to draft a spec, plan, or design doc before writing code. Even a short markdown outline dramatically improves code quality and reduces iteration cycles. Try starting sessions with "Write a brief spec for..." or "Draft an implementation plan for...".

Examples

{{extra.workspace}}: {{extra.codeLoc}} code LoC, {{extra.mdLoc}} markdown LoC ({{extra.ratioPct}}%)

Detection Logic

scan: sessions
match: true
aggregate: count
md: mdRatioByWorkspace(allSessions, thresholds.minTotalLoc, ["markdown", "md"])
emitCount: md.lowCount
emitTotal: md.totalWorkspaces
overallPct: round(md.overallRatio * 100)
totalCodeLoc: md.totalCodeLoc
totalMdLoc: md.totalMdLoc
workspaces: md.workspaces
check: md.lowCount >= thresholds.minWorkspaces
severity: md.overallRatio < 0.02