How alvindemesadev/boring-engineering works
boring-engineering is an Agent Skills-compatible guidance package, not a runtime application. An agent discovers and activates SKILL.md for coding tasks, applies its four-step decision system, and may load the decision tree or deeper principle references on demand. The README also documents before/after examples as supporting guidance. Source excerpts were unavailable, so edges reflect only relationships explicitly described in the README.
Main entry points: SKILL.md Core skill · decision-tree.md Decision tree · decision-framework.md Decision framework · kiss.md KISS guidance
Components 10
Skill workflow
- Core skill
SKILL.md
Decision references
- Decision tree
assets/decision-tree.md - Decision framework
references/decision-framework.md - KISS guidance
references/kiss.md - YAGNI guidance
references/yagni.md - Practical DRY
references/dry.md
Examples
- Anti-patterns
examples/bad-abstractions.md - Good patterns
examples/good-abstractions.md - Refactoring examples
examples/before-after.md
Other components
- AI agent
Connections 9
- AI agent → Core skill: loads on activation
README.md - Core skill → Decision tree: loads on demand
README.md - Core skill → Decision framework: loads on demand
README.md - Core skill → KISS guidance: references
README.md - Core skill → YAGNI guidance: references
README.md - Core skill → Practical DRY: references
README.md - AI agent → Anti-patterns: consults examples
README.md - AI agent → Good patterns: consults examples
README.md - AI agent → Refactoring examples: consults examples
README.md