suede-ops-architecture

Featured

Suede-owned operations-architecture discipline that fixes the shape of a system before anyone builds it: entity schema first, exactly one write path per entity, every unit of work routed to a deterministic automation, an AI agent, or a human decision, every existing tool marked absorb, keep, or kill, and the build sequenced into phases whose completion is proved by a command. Use when scoping an automation or agent build, deciding whether a workflow needs a model at all, consolidating a sprawling tool stack, designing the data model under a workflow, choosing a migration path off an old system, or ordering a build so nothing lands on a moving foundation. NOT FOR: executing a planned multi-file repo change (use suede-graph-flo-xr); coordinating parallel builders with file ownership (use suede-agent-teams); lead lifecycle, scoring, and CRM routing rules (use suede-revops); proving agent output quality against an eval set (use suede-ai-eval); reviewing the finished diff (use suede-code-review).

AI & Automation 135 stars 10 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
71
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Suede Ops Architecture ```text Ordering law: data, then workflows, then intelligence. ``` An agent reading fragmented data does not report that it holds a third of the picture. It returns a fluent, confident answer built on a third of the picture. Fragmented input produces polished mistakes at scale, and polished mistakes survive review that visible chaos would not. Architecture is what stops the model from being asked a question its inputs cannot answer. This skill ends with a written architecture, not a build. Every step below produces a line in the Output Contract, and every gate names what an agent does when it fails. ## Before Starting Collect these. Work with what exists and name what is missing in the Output Contract rather than blocking on it. 1. **Entities** — the nouns the operation runs on (client, project, order, job, track, release, patient). 2. **Work units** — the recurring things people do, one line each, in the words the person doing them uses. 3. **Tool list** — every system holding operational data, including spreadsheets, shared drives, and any inbox used as a database. 4. **Cycle length** — median days for one unit of work to go from open to done. 5. **Blast radius per work unit** — what a wrong output costs, and whether it can be undone. Read `references/triage-examples.md` for worked classifications before running Step 3 on unfamiliar work. ## Step 1 — Schema before surfaces Name the entities, their fields, and their relationships...

Details

Author
JasonColapietro
Repository
JasonColapietro/suede-creator-skills
Created
3 months ago
Last Updated
today
Language
JavaScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

architecture

Decide the shape of a software system — boundaries, contracts, NFR budgets, threat model, and ADRs — at the Shape stage between product and the build skills. Use to design the system, define the architecture, decide microservices vs monolith, draw bounded contexts, spec API/event contracts, set SLO/perf/cost budgets, threat-model (STRIDE), plan a migration or deprecation, write an ADR, or architect an agent/LLM system. Not for product discovery/PRD (→ product), UX/UI (→ design), production code (→ frontend/backend/data/ai), diagram rendering, or CI/deploy/runtime ops (→ operate).

0 Updated 1 months ago
gabros20
AI & Automation Solid

johnny-suede-design

Suede Labs AI full-stack surface builder that runs design, copy, and visual QA as one pass: landing pages, brand surfaces, product UI, dashboards, campaigns, launch pages, and reference-to-target restyles (suedify). Use when a build needs layout and words together, when a redesign or launch surface has to ship end to end, when the request is 'make this site look like that one', or when design, copy, asset, and QA lanes have to move at once. NOT FOR: a design-token, dark-mode, or single-component decision (use suede-design); copy with no layout work (use johnny-suede-write, or suede-copy for one standalone conversion surface); conversion and funnel architecture (use suede-site-alchemy); multi-agent orchestration protocols, WIP protection, and rollback trees (use suede-agent-teams).

135 Updated today
JasonColapietro
AI & Automation Listed

sota-architecture

State-of-the-art software and system architecture rules (2026) for both building and auditing. Use when designing, building, refactoring, or extending system architecture — boundaries, DDD, hexagonal/clean architecture, event-driven design, CQRS, sagas, messaging, caching, sharding, multi-tenancy, resilience, scalability, 12-factor/cloud-native — AND when auditing existing architecture for quality (design review, anti-patterns like distributed monolith or shared database, reliability/scalability assessment). Trigger keywords: architecture, system design, microservices, monolith, serverless, bounded context, DDD, aggregate, hexagonal, clean architecture, event-driven, Kafka, NATS, JetStream, messaging, pub/sub, stream, consumer, queue, saga, outbox, idempotency, CQRS, resilience, circuit breaker, retry, timeout, backpressure, caching, sharding, partitioning, multi-tenant, 12-factor, cloud-native, feature flag, ADR, scalability, anti-pattern, design review, architecture audit.

19 Updated today
martinholovsky