القائمة
Use when building or reviewing Maestro's Nim/Tatui TUI: mapping Maestro panels to Tatui widgets, constraint layout, the stdio protocol client, and headless snapshot tests.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when designing or reviewing Maestro's micro-project finite state machine: the six stages, legal transitions, approval/rollback gates, and instrumentation.
Authoritative reference to the upstream Nim language, compiler, and standard library (github.com/nim-lang/Nim). Use when you need ground-truth on Nim std modules, --mm:orc semantics, syntax, or pragmas for Maestro's TUI frontend.
Authoritative reference to the upstream Rust language and standard library (github.com/rust-lang/rust). Use when you need ground-truth on std APIs, language semantics, edition behavior, Tokio-adjacent patterns, or when a Maestro Rust question cannot be answered from local code alone.
Authoritative reference to the Tatui immediate-mode TUI library for Nim (github.com/invector-tecnologia/tatui). Use when composing Maestro panels from Tatui widgets, the constraint layout engine, the event decoder, the tick loop, or the test backend.
Use when implementing or tuning Maestro's Two-Towers persona↔skill matcher: deterministic scoring, ranking, tie-breaking, and fallback selection.
| name | tatui-frontend |
| description | Use when building or reviewing Maestro's Nim/Tatui TUI: mapping Maestro panels to Tatui widgets, constraint layout, the stdio protocol client, and headless snapshot tests. |
frontend/.scripts/install-tatui.sh (installs the exact commit behind tatui v0.1.2, Nim ≥ 2.0). Declare a bare requires "tatui" in the nimble file.Length, Percentage, Ratio, Min, Max, Fill; split with f.area.split(...).Buffer to text with no TTY → golden snapshots in CI.import tatui
var term = newTerminal(newAnsiBackend())
term.setup()
defer: term.restore()
term.draw proc(f: var Frame) =
let chunks = f.area.split(Vertical, @[length(3), fill(1)])
f.renderWidget(initBlock(title = " Maestro ", borders = AllBorders), chunks[0])
f.renderWidget(paragraph("…"), chunks[1])
| Maestro panel | Tatui widgets |
|---|---|
| Chat / conversation | Block + Paragraph + List + Scrollbar |
Agent roster + status (idle/observe/think/act/error) | Table/List + Gauge |
| FSM stepper (Ideation→…→Verification) | Tabs + Block |
| Event / message log | List + Scrollbar |
| Project lists (available/done) | Tabs + Table/List |
| System / health metrics | Sparkline + BarChart + Gauge + Chart |
| Command input | Block input + event decoder |
| Approval / rollback modal | Clear + Block + Paragraph + List |
protocol.nim).defer even on error.