git404hub

what is acme-store-sdd fr?

felipefontoura/acme-store-sdd — explained in plain English

Analysis updated 2026-05-18

1ShellAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A reference project showing how a team can practice Spec-Driven Development using a visible GitHub Projects board that automatically moves cards as work gets approved.

vibe map

mindmap
  root((repo))
    What it does
      Spec driven dev board
      Auto moves cards on approval
      Enforces branch protection
    Tech stack
      Shell
      GitHub Actions
      GitHub Projects
    Use cases
      Track team dev stages
      Spot process bottlenecks
    Audience
      Development teams
      Engineering leads

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Set up a visible GitHub Projects board that tracks a team's spec-driven development process.

VIBE 2

Automatically move a feature's board card forward each time a review stage gets approved.

VIBE 3

Enforce approval and passing checks before merging using branch protection rules.

VIBE 4

See where a team's real bottleneck is by watching where cards pile up on the board.

what's the stack?

ShellGitHub ActionsGitHub Projects

how it stacks up fr

felipefontoura/acme-store-sdd100/dotfilesadams549659584/my-openwrt-actions
Stars111
LanguageShellShellShell
Last pushed2016-11-182020-06-06
MaintenanceDormantDormant
Setup difficultymoderateeasyhard
Complexity3/51/53/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires creating a GitHub repo, running a setup script, and adding a fine-grained access token as a secret.

in plain english

Acme Store is a small reference project that shows how a team can practice something called Spec-Driven Development, or SDD, using tools that most teams on GitHub already have access to. It is a companion example for a separate project called the Pi SDD Kit, and its whole purpose is to demonstrate one specific idea: that this careful way of planning and building software can be done openly, as a team, with everyone able to see where each piece of work stands. The core method behind SDD is a sequence of stages that a feature moves through, starting with an idea and a plan, then a written requirements document, a detailed specification, a task breakdown, the actual coding work, and finally a review, before being marked done. Each step in that sequence requires a human to approve it before the work can move to the next stage. This repository's contribution is connecting that sequence to a visible GitHub Projects board, so the current stage of every feature is something the whole team can see at a glance, rather than something tracked only in someone's head or a private document. Behind the scenes, each feature keeps a small file that records its current stage and whether it has been approved. A GitHub Actions workflow watches for changes to that file, and automatically moves the corresponding card on the project board to the next column the moment an approval happens. Rules on the main branch also require an approval and passing checks before anything can be merged, so the approval step becomes something enforced by the system, not just a suggestion. Setting this up involves creating a new GitHub repository, running an included script that creates the project board's columns and configures branch protection, and adding an access token so the automation is allowed to move cards. The author frames the board as more than documentation: watching where work piles up on it, especially during the coding stage, reveals where a team's real bottleneck actually is.

prompts (copy fr)

prompt 1
Walk me through setting up this GitHub Projects board using the setup-board.sh script.
prompt 2
Explain how the .status file drives which column a card sits in.
prompt 3
Help me configure the PROJECT_TOKEN secret so the Action can move cards.
prompt 4
Explain the difference between the Pi SDD Kit and this reference repo.

Frequently asked questions

what is acme-store-sdd fr?

A reference project showing how a team can practice Spec-Driven Development using a visible GitHub Projects board that automatically moves cards as work gets approved.

What language is acme-store-sdd written in?

Mainly Shell. The stack also includes Shell, GitHub Actions, GitHub Projects.

How hard is acme-store-sdd to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is acme-store-sdd for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.