convez.ai
AgenteDevOps & InfraestruturaAvançado
flying-dice

PseudoScript

flying-dice/pseudoscript

Architecture-as-code: modelo em pseudocódigo, implementação guiada

Ver no GitHub
InicialPluginScore · de 0 a 100

Um toolkit de engenharia dirigida por modelos (MDE) que separa o design do sistema de sua implementação. Você escreve pseudocódigo arquitetural, a ferramenta valida e gera diagramas C4 e de sequência que equipes e agentes usam como referência.

Instalação

$npx convez-ai flying-dice/pseudoscript

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
25%
Último commit
há 4 meses
Versão
v0.1.7
Issues abertas
3
Contribuidores
5

Casos de uso

  • Documentar arquitetura de sistemas como código versionável
  • Gerar diagramas C4 e sequência automaticamente a partir do modelo
  • Orquestrar agents LLM com modelos validados como spec

Veredito

Ferramenta madura e bem arquitetada para times que querem tratar arquitetura como código-primeira. Ideal para sistemas complexos e colaboração entre humanos e agentes, mas requer curva de aprendizado do DSL e mentalidade MDE.

README

A tradução para o português deste README ainda está na fila.

PseudoScript

Model the intent. Implement the detail.

Architecture-as-code for the agentic era. Write your system as plain pseudocode; the toolchain validates the model and generates the C4 and sequence diagrams your team and your agents build against. Model-driven engineering, reignited.

Open the Web IDE → · Language spec · Patterns


Where things are

PathWhat it is
LANG.mdThe normative language spec (§1–§12). The source of truth.
PATTERNS.mdIdioms and recipes for modelling in PseudoScript.
CONFORMANCE/The executable contract — lexical, syntax, static, generation cases.
decisions/Architecture Decision Records, one per resolved fork.
crates/The Rust toolchain: parser, checker, formatter, diagram emitter, LSP, and the pds binary.
web-ide/The browser IDE — the whole toolchain compiled to WebAssembly.
web-landing/The marketing site.
model/PseudoScript modelling its own design — the compiler crates, the web IDE, and the landing site.

The pds CLI

pds init          # scaffold a workspace
pds eval          # read a model from stdin, report diagnostics (great for agents)
pds check <file>  # check a file or workspace
pds doc --serve   # render the live C4 + sequence-diagram doc site
pds lang | pds skill   # print the grammar / authoring method for an LLM

Building a model with an agent? pds skill and pds lang teach it the method and grammar; pds eval lets it check its work as it goes.

Ver o original no GitHub

Bom para

Relacionados