tekton

Render architecture models from YAML into interactive HTML viewers.

3|2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/broomva/skills --skill tekton-broomva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tekton
Source: https://github.com/broomva/skills/tree/main/skills/design/tekton
Command: npx skills add https://github.com/broomva/skills --skill tekton-broomva

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Tekton solves the disconnect between human-authored architecture diagrams and the actual system implementation by providing a single, version-controlled YAML model that both humans and agents can read, write, and query.

Core Features & Use Cases

  • Shared Architecture Substrate: Maintains a single source of truth across six tiers including system, journey, data, infra, decisions, and qualities.
  • Fitness Functions: Automatically validates design rules like no-cycle constraints or layer-ordering via the tekton lint command.
  • Interactive Visualization: Generates self-contained, on-brand HTML viewers that support C4-style drill-downs and cross-tier traceability.

Quick Start

Use the tekton skill to render the architecture model defined in your project design file into an interactive HTML viewer.

Frequently Asked Questions about tekton

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain a shared architecture model that both humans and agents can edit?

A shared architecture model uses a unified YAML substrate to define system intent, allowing both humans and agents to read, write, and query the same version-controlled source of truth across six architectural tiers.

How do I validate architecture rules and prevent design violations in my system?

To validate architecture rules, implement fitness functions that automatically lint the YAML model for design constraints like no-cycle dependencies and layer-ordering to ensure structural integrity.

Can I generate interactive HTML visualizations directly from my architecture YAML model?

Yes, you can generate interactive HTML visualizations directly from the YAML model, creating self-contained viewers that support C4-style drill-downs and cross-tier traceability for system analysis.

What is the best way to trace system requirements across infrastructure and data tiers?

The best way to trace requirements across tiers is to use a unified architecture substrate that maps relationships between system, journey, data, and infra tiers within a single diff-friendly YAML model.

Do I need pyyaml to parse and manage architecture intent files?

Yes, you need the pyyaml dependency to parse the YAML files that store the architecture intent, enabling automated querying and design validation across the co-design model.