Skip to content

jonathan-pap/blueprints

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Workspace Blueprint

A collection of self-contained folder-as-app blueprints for working with various data / BI tools. Each blueprint follows the 3-Layer Folder Architecture: a top-level map, rooms that load only when needed, and atomic step files that load only when their workflow runs.

How to use

  1. Point Claude (or any LLM that can read folders) at this directory.
  2. Tell it to read CLAUDE.md — the blueprint directory.
  3. Pick the blueprint that matches your task. Claude follows that blueprint's own CLAUDE.md from there.

Starting a new piece of work? See briefs/ — a shared hub with brief templates (linked to each blueprint) and filled example briefs to learn from.

Current blueprints

Blueprint Tool Status
power-bi/ Power BI Desktop (PBIP format) Complete — ~493 atomic files across 4 rooms (with nested sub-rooms)
synthetic-data/ Synthetic / dummy data creation (Python-first) Skeleton — 5 rooms + Power BI hand-off; rooms grow per job

Why folder-as-app

Each blueprint:

  • Loads only the atomic step files needed for the current task (typical: 3–10 KB of context, not 30+ KB)
  • Is portable — copy the folder into any project to work alongside it
  • Uses no external state — the file system is the database, file names are the index

Adding a new blueprint

Create a top-level kebab-case folder. Follow the same pattern: CLAUDE.md, README.md, numbered rooms, projects/, outputs/, _examples/. Add a one-line entry to the root CLAUDE.md's "Available blueprints" list.

Architecture reference

For the full walkthrough with workflow diagrams (intent routing, brief-first execution, 3-tier live-model preference, theme creation, hook subsystems) and an atomic-vs-plugin cost comparison, see HOW-IT-WORKS.md.

The 3-Layer Folder Architecture itself is documented in power-bi/_examples/AI_Folder_Architecture.pdf. Watch the original video: Stop Building AI Agents. Use This Folder System Instead.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors