store-builder SKILL.md skillA

store-builder from gecko-academy/dev3pack-cohort-2026-09 is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add gecko-academy/dev3pack-cohort-2026-09/store-builder@git:20260904.280c57f

Pins git:20260904.280c57f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
gecko-academy/dev3pack-cohort-2026-09
Path
builder-kit/plugin/skills/store-builder/SKILL.md
Versions recorded
1
Latest version
git:20260904.280c57f, committed Sep 4, 2026
Size
2,920 bytes
Repository stars
10
License
MIT

Use when building an autonomous store or shop agent system (orders, catalog, delivery) — scaffolds the Waiter / Store Manager / Delivery pattern with bounded tools, an explicit state graph, and the receipt rule. From the Dev3Pack bootcamp.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Building an autonomous store — the Waiter/Manager/Delivery pattern

## When to use

The user wants agents that take orders, manage a catalog, or fulfill
deliveries — a shop, a café, a marketplace stall. NOT for general chatbots
(no catalog, no fulfillment = no store).

## The pattern (three bounded agents, never one omnipotent one)

- **Waiter** — the only agent that talks to the customer. Read-only tools over
  the Manager's catalog: `list_menu()`, `check_item(name)`, `quote(name, qty)`.
  Refuses unknown items and out-of-stock items with DIFFERENT, explicit
  reasons.
- **Store Manager** — owns the catalog (items, prices, mints/SKUs, stock) and
  validates every order against it. The catalog is data the Waiter reads, not
  text pasted into prompts.
- **Delivery** — an explicit state machine:
  `ordered → paid → delivering → delivered`, plus failure states
  (`payment_failed`, `undeliverable_zone`). Illegal transitions RAISE. Every
  transition appends a trace event.

## Workflow

1. Draw the delivery state graph in mermaid BEFORE coding; every arrow becomes
   a test.
2. Build the Manager's catalog as typed data (dataclass/JSON), then the
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add gecko-academy/dev3pack-cohort-2026-09/store-builder@sha256:27ad413030d3a880

The line at the top of this page pins the label git:20260904.280c57f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_yhvtwfwhpru7vukb.svg)](https://markdownregistry.com/a/art_yhvtwfwhpru7vukb)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 4, 2026.

versioncommittedcommitsizeaudit
git:20260904.280c57f latest2026-09-04 280c57f 2,920 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2920 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

gecko-academy/dev3pack-cohort-2026-09 · 10 stars · license MIT · pushed 2026-10-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yhvtwfwhpru7vukb
GET https://markdownregistry.com/api/v1/resolve?ref=gecko-academy/dev3pack-cohort-2026-09/store-builder
GET https://markdownregistry.com/api/v1/blob/27ad413030d3a880010bf5b178ec44f4d20a73f2ea06a725b39df6891ee26702

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from gecko-academy/dev3pack-cohort-2026-09

ask-the-course SKILL.md skill
gecko-academy/dev3pack-cohort-2026-09 · .claude/skills/ask-the-course/SKILL.md · Use when a learner asks a question about the course itself (a session, an exercise, a command, a rule, the capstone)…
git:20260928.54265af · audit A · 10 stars
check-my-exercise SKILL.md skill
gecko-academy/dev3pack-cohort-2026-09 · .claude/skills/check-my-exercise/SKILL.md · Use when a session check fails and the learner wants to know why. Runs the session check, reads the failure out loud…
git:20260923.f226cf5 · audit A · 10 stars
fix-my-setup SKILL.md skill
gecko-academy/dev3pack-cohort-2026-09 · .claude/skills/fix-my-setup/SKILL.md · Use when the course will not run at all, because of uv, a missing package, Ollama or its models, a notebook that still…
git:20260923.f226cf5 · audit B · 10 stars
hand-my-work-in SKILL.md skill
gecko-academy/dev3pack-cohort-2026-09 · .claude/skills/hand-my-work-in/SKILL.md · Use when a learner is ready to submit a session. Saves the notebook first, runs the session check, then submits. Covers…
git:20260923.f226cf5 · audit A · 10 stars
run-a-project SKILL.md skill
gecko-academy/dev3pack-cohort-2026-09 · .claude/skills/run-a-project/SKILL.md · Use when a learner opens one of the optional projects under projects/. Installs both extras in one command, pulls the…
git:20260923.f226cf5 · audit A · 10 stars
ship-my-capstone SKILL.md skill
gecko-academy/dev3pack-cohort-2026-09 · .claude/skills/ship-my-capstone/SKILL.md · Use when a learner wants to start, grade, hand in, or check the score of their final assignment (the research…
git:20261004.730521d · audit B · 10 stars
study-a-session SKILL.md skill
gecko-academy/dev3pack-cohort-2026-09 · .claude/skills/study-a-session/SKILL.md · Use when a learner wants to understand one bootcamp session before doing its exercise. Reads that session's pages…
git:20260923.f226cf5 · audit A · 10 stars
bootcamp Cursor rule
gecko-academy/dev3pack-cohort-2026-09 · .cursor/rules/bootcamp.mdc · Bootcamp project rules (canonical policy in AGENTS.md)
git:20260923.df9f4c2 · audit A · 10 stars
AGENTS.md AGENTS.md file
gecko-academy/dev3pack-cohort-2026-09 · AGENTS.md
git:20260928.54265af · audit B · 10 stars
CLAUDE.md CLAUDE.md file
gecko-academy/dev3pack-cohort-2026-09 · CLAUDE.md
git:20260923.df9f4c2 · audit A · 10 stars
corpus-answers SKILL.md skill
gecko-academy/dev3pack-cohort-2026-09 · builder-kit/plugin/skills/corpus-answers/SKILL.md · Use when answering questions from a local document corpus — requires verified citations, refusal on unsupported…
git:20260904.280c57f · audit A · 10 stars
AGENTS.md@capstone-template AGENTS.md file
gecko-academy/dev3pack-cohort-2026-09 · capstone-template/AGENTS.md
git:20260930.6bfb8e9 · audit B · 10 stars

Every file in gecko-academy/dev3pack-cohort-2026-09

Browse by kind, by grade A, or by owner.