Skip to main content

Component Gap Analysis - 2026-02-06

Executive Summary

Systematic audit of 3,382 components across 6 types reveals significant metadata gaps, track assignment violations, and quality score deficits. The 495 enterprise-specialist agents created on 2026-02-06 (H.10.6) expanded the agent count to 766 but introduced 640+ components without config JSON, agent cards, or linked skills.

Overall compliance: ~48% - Nearly half of all discoverable components are orphaned or missing required fields per ADR-054/ADR-116.


Component Inventory (Current State)

TypeCountSource
Agents767agents/*.md
Skills429skills/*/SKILL.md
Commands364commands/*.md
Hooks109hooks/*.py (63) + hooks/*.sh (20) + hooks/*.md (26)
Scripts557scripts/**/*.py + scripts/**/*.sh
Workflows1,153workflows/**/*.json + workflows/**/*.yaml
Total3,379config/component-counts.json says 3,382

1. AGENTS (767 files)

1.1 Track Field Compliance

StatusCount%
Has track: field76699.9%
Missing track:1<0.1%
Broken template value ({spec.get...})20.3%

Track coverage is strong. The 2 broken template values are in plugin-developer.md.

1.2 Required Field Gaps

FieldPresentMissing% MissingSeverity
name22954170.5%CRITICAL
description22154671.2%CRITICAL
domain22754070.3%CRITICAL
status56120626.8%HIGH
quality_score53423330.4%HIGH
moe_role54322429.2%MEDIUM
moe_capabilities53623130.1%MEDIUM
invocation_pattern54022729.6%MEDIUM
audience54622128.8%MEDIUM
component_type76520.3%LOW
moe_confidence742253.3%LOW

1.3 Config JSON and Agent Cards

ComponentExistMissing% Missing
config/agents/*.json12764083.4%
config/agent-cards/*.json12364584.0%

1.4 Cross-References (Agent to Other Components)

Referenced ComponentAgents Referencing%
skills/405.2%
scripts/476.1%
commands/283.6%
hooks/273.5%
Any component~526.8%
Completely isolated71593.2%

1.5 Agent Tier Analysis

TierCountLines/AgentCreatedFieldsQuality
Tier 1 (Established)~130300-7502025-12-2225 fieldsFull sections
Tier 2 (Enterprise)~49540-802026-02-067-16 fieldsMinimal
Tier 1.5 (Mixed)~14250-500Various10-25 fieldsVariable

1.6 Content Section Coverage

SectionPresent%Gap
Implementation Patterns405.2%94.8% missing
Usage Examples8310.8%89.2% missing
Quality Standards8911.6%88.4% missing
Completion Checklist17322.5%77.5% missing
Anti-Patterns17723.1%76.9% missing
Failure Indicators16020.8%79.2% missing

1.7 Model Field Inconsistency

ValueCountStandard?
sonnet729YES
claude-sonnet-417NO - should be sonnet
opus9YES
haiku3YES
claude-opus-4-5-202511011NO - should be opus

2. SKILLS (429 SKILL.md files)

2.1 Track Field Compliance

StatusCount%
Has track: field9622.4%
Missing track:33377.6%

CRITICAL: CLAUDE.md mandates track: on every skill. 77.6% non-compliant.

2.2 CEF Track vs PILOT Track

FieldPresentMissing% Present
cef_track:428199.8%
track: (PILOT)9633322.4%

Skills have cef_track (CEF taxonomy) but not track (PILOT governance). These map differently.

2.3 Required Field Gaps

FieldPresentMissing% MissingSeverity
track9633377.6%CRITICAL
quality_score842198.1%CRITICAL
component_type32511627.0%HIGH
moe_confidence3458419.6%MEDIUM
audience26516438.2%MEDIUM
skill_name23419545.5%MEDIUM
skill_category23319645.7%MEDIUM
keywords30312629.4%LOW

2.4 Content Quality

Size RangeCount%
500+ lines16338.0%
300-499 lines12028.0%
200-299 lines7818.2%
100-199 lines5412.6%
50-99 lines143.3%

84.2% of skills are 200+ lines - content quality is strong.

2.5 Cross-References

Reference TypeCount%
References scripts/13932.4%
References other skills/4711.0%
References hooks/4510.5%
References agents/4410.3%
References commands/368.4%

3. COMMANDS (364 files)

3.1 Track Field Compliance

StatusCount%
Has track: field5515.1%
Missing track:30984.9%

3.2 Required Field Gaps

FieldPresentMissing% MissingSeverity
track5530984.9%CRITICAL
quality_score0364100%CRITICAL
status3244011.0%HIGH
moe_confidence3174712.9%MEDIUM
component_type349154.1%LOW

3.3 Script Backing

StatusCount%
Commands with scripts/ reference15643.0%
Commands WITHOUT script backing20857.3%

3.4 Content Distribution

Size RangeCount%
500+ lines3710.2%
200-499 lines18049.6%
100-199 lines8724.0%
50-99 lines5013.8%
<50 lines102.8%

4. HOOKS (109 files)

4.1 File Type Distribution

TypeCount
Python .py63
Shell .sh20
Markdown .md26

4.2 Track Field Compliance

StatusCount%
Has track: field (.md)00%
Missing track: (.md)26100%

ALL hook documentation files missing track: field.

4.3 Documentation Gap

StatusCount
.py hooks with matching .md doc0
.py hooks without .md doc63

Python hooks rely on inline docstrings only - no separate markdown documentation.


5. CROSS-COMPONENT ORPHAN ANALYSIS

Orphaned Components (Zero References from Other Components)

TypeOrphanedTotal% Orphaned
Agents41676754.2%
Skills21042949.0%
Commands12436434.1%
Total7501,56048.1%

6. TRACK COVERAGE MATRIX (A-N)

TrackAgentsSkillsCommandsHooksTotal
A (Backend)19120031
B (Frontend)2130024
C (DevOps)2442030
D (Security)820010
E (Testing)2176034
F (Docs)18102030
G (DMS)31105
H (Framework)12716160159
I (UI)480012
J (Memory)1482024
K (Workflow)684018
L (Ext Testing)40004
M (Ext Security)41207
N (GTM)6320065
UNASSIGNED~1~333~309~26~669

67.5% of non-agent components lack track assignment.


7. COMPLIANCE SUMMARY TABLE

FieldAgents (767)Skills (429)Commands (364)Hooks (26 .md)
component_type99.7%73.0%95.9%92.3%
track99.9%22.4%15.1%0%
status73.1%92.1%89.0%100%
version98.8%98.4%94.8%100%
quality_score69.6%1.9%0%0%
moe_confidence96.7%80.2%87.1%84.6%

8. REMEDIATION TASK MAP

These map to H.10 tasks in TRACK-H-CEF-EXPERIENCE-FRAMEWORK.md:

Task IDDescriptionComponentsEffort
H.10.1Fix 2 broken template agents2 agents15min
H.10.2Naming convention fixes2 skills15min
H.10.3Add track: to 333 skills333 skills4-6h
H.10.4Add track: to 309 commands309 commands3-4h
H.10.5Add track: to 26 hook .md files26 hooks1h
H.10.6Enterprise agent inventoryCOMPLETE-
H.10.7Generate 640 config/agents/*.json640 agents4-6h
H.10.8Generate 645 config/agent-cards/*.json645 agents4-6h
H.10.9Add quality_score to commands + hooks390 files2-3h
H.10.10Add quality_score to 421 skills421 skills3-4h
H.10.11Add status to 206 agents206 agents2-3h
H.10.12Add name/description/domain to 540+ agents540 agents4-6h
H.10.13Standardize model field (18 non-standard)18 agents30min
H.10.14Add component_type to 116 skills116 skills1-2h
H.10.15Component reference validation hook1 hook2-4h

Total estimated effort: 30-46 hours


9. STALENESS INDICATORS

MetricCount%
Agents with 2025 update dates14018.2%
Skills with 2025 update dates18944.0%
Commands with 2025 update dates14439.6%
Agents created same day (bulk)36347.3%

Analysis by: Claude (Opus 4.6) Date: 2026-02-06T21:00:00Z Referenced by: TRACK-H-CEF-EXPERIENCE-FRAMEWORK.md, Section H.10