Skip to content

README.md

Latest commit

 

History

History
82 lines (60 loc) · 2.85 KB

README.md

File metadata and controls

82 lines (60 loc) · 2.85 KB

GRTS

GRTS

📄 Slide deck (PDF)

Download / view: slides/GRTS.pdf

🌐 Slide deck (HTML)

Download / view: slides/GRTS.html

GRTS is a practical system for working with coding agents:

  • 🟢 Guidance 🧭 — how to prompt and supervise
  • 🔴 Reality / Rules / Roles 🧱 — how to ground the agent in your repo and constraints
  • 🟡 Tools 🧰 — how to let the agent take safe, useful actions
  • 🔵 Specifications ✅ — how to make “done” measurable and reviewable

Intent 🎯

Help software developers confidently enter the agentic era: getting real leverage from agents while staying safe, correct, and in control.

Motivation ⚡

You will not be replaced by an agent, but you may be replaced by someone who can direct one well.

Vibe coding without a process is like handing over your repo to a drunken robot 🍺🤖!

Contributing and feedback 💬

This is a learning system. Feedback and improvements are welcome.

Good contributions:

  • Tightening language without changing meaning
  • Fixing layout/fit issues (especially after content changes)
  • Improving examples/checklists while keeping the deck concise
  • Adding or refining references (with clear relevance to G/R/T/S)

Good feedback:

  • What felt confusing or too abstract
  • What was missing to apply this in a real repo
  • Where the deck over-promises or under-explains

Repo contents (where things live) 🗂️

This repository contains the canonical GRTS deck and its assets.

Source of truth 📌

  • Slide deck (Marp): slides/GRTS.md
  • Exported PDF: slides/GRTS.pdf
  • Exported HTML: slides/GRTS.html
  • Logo: GRTS.png
  • Deck assets (e.g., diagrams): slides/assets/

Build prerequisites

  • Node.js + npm/npx
  • There is no package.json in this repo, so npm ci will fail. Use npx commands (below) or the VS Code tasks.

Export (PDF) 🖨️

Use the VS Code task Export GRTS slides (PDF), or run:

npx --yes @marp-team/marp-cli@latest slides/GRTS.md --pdf --allow-local-files -o slides/GRTS.pdf

Notes:

  • --allow-local-files is required for the logo and local assets.
  • The deck is intended to use standard Marp features (no custom engines/plugins).

Export (HTML)

Use the VS Code task Export GRTS slides (HTML), or run:

npx --yes @marp-team/marp-cli@latest slides/GRTS.md --html --allow-local-files -o slides/GRTS.html

Present (speaker notes)

Use the VS Code task Present GRTS slides (Speaker notes), or run:

npx --yes @marp-team/marp-cli@latest slides/GRTS.md --preview --allow-local-files

Diagrams (Mermaid)

If you edit slides/assets/grts-slide2-flowchart.mmd, regenerate the committed SVG via the VS Code task Regenerate Mermaid SVGs (or rerun the PDF export task, which depends on it).