interior-design-os
Bootstrap a complete Notion OS for an interior design studio. Orchestrates the other 5 notion-* skills in the correct order. End-to-end target: under 2 hours from empty workspace to seeded OS + walkthrough doc.
What gets built
- 9 sections, 19 databases, full cross-DB relations
- 8 helper formulas (Is Overdue, SLA Breach, Is Active, Needs Follow-up, etc.)
- 5 rollups (Checklist Done/Total, Task Done/Total, Handover Completion %)
- ~25 task templates with dependency-wiring
- ~25 QC checklist items, ~29 drawing-register entries, 44 handover items
- Operations Cockpit page with Decision Queue + KPIs + filtered views
- Personalized walkthrough doc (Jinja2 templated)
- GitHub Actions for hourly task auto-seeding + Monday Weekly Status Log
Prerequisites
NOTION_API_KEY env var- A root page created in the target Notion workspace, shared with the integration
- That page's ID
- The
chiragg-ds/interior-design-os template repo (cloned via gh repo create --template)
client.config.yaml populated (brand name, GST rate, fee stages, work scopes)
Steps
Confirm config — verify client.config.yaml has been edited from the example. Required fields: client.name, brand.name, financials.gst_rate, financials.fee_stages, financials.invoice_due_days, notion.root_page_id.
Provision (notion-provision) — sections + DBs:
python3 notion-os/provision.py
Validate: ids.json written with all 19 DBs.
Schema dump (notion-schema-dump) — generate canonical reference:
python3 notion-os/dump_schema.py
Helper formulas (notion-helper-formulas) — apply Studio Nuvah formula presets:
python3 notion-os/add_helper_formulas.py
Seed templates (notion-seed) — load all 4 seed files:
python3 notion-os/seed_all.py
Cockpit (notion-cockpit) — render Operations Dashboard:
python3 notion-os/build_cockpit.py
Walkthrough — render branded doc:
python3 scripts/generate_walkthrough.py
Hand off to client:
- Walk through
docs/WALKTHROUGH.md
- Walk through
docs/MANUAL-UI-STEPS.md (Cockpit linked views, native automations, permissions)
- Configure
NOTION_API_KEY secret in GitHub Actions for the auto-seed + weekly-status workflows
When to use this skill
- Onboarding a new interior-design client.
- Spinning up a test workspace to validate template changes.
When NOT to use
- For a non-interior-design vertical (architect, photographer, event-planner). Compose the other 5 skills with that vertical's seeds + cockpit spec instead.
- For surgical edits to an existing OS. Use the underlying skills (
notion-helper-formulas, notion-seed, etc.) directly.
Why a meta-skill
Each underlying primitive skill is vertical-agnostic and reusable. This meta-skill captures the interior-design opinion: which DBs, which seeds, which formulas, which cockpit layout. Future vertical meta-skills (architect-os, furniture-studio-os) will compose the same primitives differently.
1---2name: interior-design-os3description: End-to-end bootstrap of an opinionated Notion CRM + Operations OS for an interior design studio. Orchestrates the other 5 notion-* skills. Use when onboarding a new interior designer client.4---56# interior-design-os78Bootstrap a complete Notion OS for an interior design studio. Orchestrates the other 5 `notion-*` skills in the correct order. End-to-end target: under 2 hours from empty workspace to seeded OS + walkthrough doc.910## What gets built1112- 9 sections, 19 databases, full cross-DB relations13- 8 helper formulas (Is Overdue, SLA Breach, Is Active, Needs Follow-up, etc.)14- 5 rollups (Checklist Done/Total, Task Done/Total, Handover Completion %)15- ~25 task templates with dependency-wiring16- ~25 QC checklist items, ~29 drawing-register entries, 44 handover items17- Operations Cockpit page with Decision Queue + KPIs + filtered views18- Personalized walkthrough doc (Jinja2 templated)19- GitHub Actions for hourly task auto-seeding + Monday Weekly Status Log2021## Prerequisites2223- `NOTION_API_KEY` env var24- A root page created in the target Notion workspace, shared with the integration25- That page's ID26- The `chiragg-ds/interior-design-os` template repo (cloned via `gh repo create --template`)27- `client.config.yaml` populated (brand name, GST rate, fee stages, work scopes)2829## Steps30311. **Confirm config** — verify `client.config.yaml` has been edited from the example. Required fields: `client.name`, `brand.name`, `financials.gst_rate`, `financials.fee_stages`, `financials.invoice_due_days`, `notion.root_page_id`.32332. **Provision (notion-provision)** — sections + DBs:34 ```bash35 python3 notion-os/provision.py36 ```37 Validate: `ids.json` written with all 19 DBs.38393. **Schema dump (notion-schema-dump)** — generate canonical reference:40 ```bash41 python3 notion-os/dump_schema.py42 ```43444. **Helper formulas (notion-helper-formulas)** — apply Studio Nuvah formula presets:45 ```bash46 python3 notion-os/add_helper_formulas.py47 ```48495. **Seed templates (notion-seed)** — load all 4 seed files:50 ```bash51 python3 notion-os/seed_all.py52 ```53546. **Cockpit (notion-cockpit)** — render Operations Dashboard:55 ```bash56 python3 notion-os/build_cockpit.py57 ```58597. **Walkthrough** — render branded doc:60 ```bash61 python3 scripts/generate_walkthrough.py62 ```63648. **Hand off to client**:65 - Walk through `docs/WALKTHROUGH.md`66 - Walk through `docs/MANUAL-UI-STEPS.md` (Cockpit linked views, native automations, permissions)67 - Configure `NOTION_API_KEY` secret in GitHub Actions for the auto-seed + weekly-status workflows6869## When to use this skill7071- Onboarding a **new** interior-design client.72- Spinning up a **test workspace** to validate template changes.7374## When NOT to use7576- For a non-interior-design vertical (architect, photographer, event-planner). Compose the other 5 skills with that vertical's seeds + cockpit spec instead.77- For surgical edits to an existing OS. Use the underlying skills (`notion-helper-formulas`, `notion-seed`, etc.) directly.7879## Why a meta-skill8081Each underlying primitive skill is vertical-agnostic and reusable. This meta-skill captures the **interior-design opinion**: which DBs, which seeds, which formulas, which cockpit layout. Future vertical meta-skills (`architect-os`, `furniture-studio-os`) will compose the same primitives differently.
chiragg-ds