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.