| name | g-skl-auto-triage |
| description | Triage non-code defects (spec_defect, policy_incongruity, design_gap): assess risk, auto-fix bounded safe issues, and log the rest as tracked bugs. |
Purpose
Close the "detect and forget" loop. When a non-code defect is discovered (spec_defect, policy_incongruity, design_gap), this skill:
- ASSESSes risk — computes a numeric score; high risk = do not touch
- FIXes bounded, safe issues automatically (score ≤ threshold)
- LOGs every attempt to the audit trail regardless of outcome
The goal is not to be brave. The goal is to leave fewer things silently broken.
subsystem_memberships: [BUG_AND_QUALITY, AGENT_ORCHESTRATION]
--- risk — computes a numeric score; high risk = do not touch
2. FIXes bounded, safe issues automatically (score ≤ threshold)
3. LOGs every attempt to the audit trail regardless of outcome
The goal is not to be brave. The goal is to leave fewer things silently broken.
Operations
ASSESS
Compute risk score without writing anything.
ASSESS bug_id=BUG-098 kind=spec_defect files=["workspace_manifest.yaml"]
Returns:
risk_score: 1.5
eligible: true
reason: "spec_defect + single schema file + comment-only fix"
FIX
Attempt a bounded auto-fix. Only runs if risk_score ≤ auto_triage_risk_threshold (default: 2.0).
FIX bug_id=BUG-098 kind=spec_defect fix_type=schema_comment
Fix types available in Phase 1:
schema_comment — append clarifying comment to a YAML schema valuemanifest_annotation — add NOTE: inline to workspace_manifest.yamlcommand_annotation — add BUG[BUG-NNN] comment at bug site in a command filerule_annotation — add BUG[BUG-NNN] comment at bug site in a rule fileconstraint_expire — mark a constraint status: archived when expiry conditions are clearly met
LOG
Write an audit entry regardless of outcome. Called internally by FIX but can be called standalone.
LOG bug_id=BUG-098 outcome=auto_resolved risk_score=1.5 note="Added clarifying comment"
Appends to: .gald3r/logs/triage_auto_YYYYMMDD.log
Risk Score Reference
risk_score = base_kind_score + file_sensitivity_bonus + scope_multiplier
Base kind scores
| kind | base_score | Notes |
|---|
code | ∞ | NEVER auto-triage — code bugs go to normal fix path |
spec_defect | 1.0 | Safe starting point |
policy_incongruity | 2.0 | Borderline — only simplest fixes |
design_gap | 3.0 | Always needs_attention — human decision required |
File sensitivity bonus (added to base)
| File type | Bonus |
|---|
| Schema YAML comment | +0.0 |
| Manifest annotation | +0.5 |
Rule file (.mdc) | +1.0 |
| Command file | +1.0 |
AGENT_CONFIG.md | +1.0 |
CONSTRAINTS.md body | +∞ (block) |
TASKS.md, tasks/ | +∞ (block) |
BUGS.md, bugs/ | +∞ (block) |
workspace/ topology | +∞ (block) |
| Any source code file | +∞ (block) |
Scope multiplier
| Files affected | Multiplier |
|---|
| 1 file | ×1.0 |
| 2–3 files | ×1.5 |
| >3 files | ×∞ (block) |
Threshold (Phase 1): risk_score ≤ 2.0 → attempt fix.
Outcome States
triage_status | Meaning | Bug badge |
|---|
auto_resolved | Fix applied cleanly | ✅ |
needs_attention | Human required (risk too high or fix failed) | 🚨 |
blocked_by_risk | Score exceeded threshold — logged, no write made | ⛔ |
deferred_verify | Fix applied, human should confirm before closing | 🔍 |
not_attempted | Triage not yet run for this bug | — |
Bug Frontmatter Fields (added by this skill)
kind: spec_defect
triage_status: auto_resolved
triage_risk_score: 1.5
triage_attempted: '2026-05-21T11:55:00Z'
triage_notes: 'Added clarifying comment to workspace_manifest.yaml line 1205'
Phase 1 Hard Limits (DO NOT EXCEED)
- Never touch
TASKS.md, tasks/, BUGS.md, bugs/ — coordination state is sacred
- Never touch
CONSTRAINTS.md body text
- Never touch
workspace/ topology files
- Never touch source code in member repos
- Never fix anything requiring a design decision (
design_gap)
- Never fix more than 3 files in a single triage run
- Always write to audit log — even if no fix was attempted
- Always verify the file was written cleanly after a write
Invocation (via scripts)
# Assess only
gald3r bug triage --dry-run --kind "spec_defect" --file "workspace_manifest.yaml" --fix-type "schema_comment"
# Full triage (assess + fix if safe + log)
gald3r bug triage --bug-id "BUG-098" --kind "spec_defect" --file "<workspace>/<gald3r_source>/.gald3r/linking/workspace_manifest.yaml" --fix-type "schema_comment" --project-root "<workspace>/<gald3r_source>"
Audit Log Format
2026-05-21T11:55:00Z | BUG-098 | spec_defect | risk=1.5 | auto_resolved | Added clarifying comment to workspace_manifest.yaml
2026-05-21T11:56:00Z | BUG-099 | policy_incongruity | risk=3.5 | blocked_by_risk | Score exceeds threshold 2.0
Phase 2 Expansion (future — not implemented)
- Higher threshold option (
auto_triage_risk_threshold: 3.5)
design_gap human-prompt mode (surfaces a proposed resolution, waits for approval)- Integration with
g-go-code as a pre-step impact classifier
- Cross-platform parity sync after spec_defect auto-resolve
