skills.rest
baristaze
baristazeCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

arch-scaffold-namespace

Scaffolds an object-model namespace with manager, storage, and root wiring in Python.

89|10|Updated Sep 15, 2026
Search Tags:#architecture#multi-tenant#python#code generation#scaffold#namespace#postgres
One-click install
npx skills add https://github.com/baristaze/swe_guidelines --skill arch-scaffold-namespace-baristaze
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arch-scaffold-namespace
Source: https://github.com/baristaze/swe_guidelines/tree/main/skills/arch-scaffold-namespace
Command: npx skills add https://github.com/baristaze/swe_guidelines --skill arch-scaffold-namespace-baristaze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new namespace (swimlane) in a multi-tenant, service-based Python system requires creating many interlocking files—manager interfaces, storage implementations for Postgres and memory, and wiring into both roots—which is repetitive and error-prone when done by hand. ## Core Features & Use Cases - Namespace Scaffolding: Creates the full namespace directory structure under om/src/<root>/om/<ns>/, including manager interface, types, impl, storage interfaces, Postgres and memory implementations, and a README. - Root Wiring: Updates the storage root and manager root with new getters, constructor wiring, and unit test assertions. - Entity Delegation: When a first entity is named, forwards entity arguments, role, and scope to the entity scaffold skill so the namespace reaches the API with routes. - Use Case: Run the skill with inventory Warehouse address:str timezone:str to create a complete inventory namespace with a Warehouse entity, storage in Postgres and memory, and all root wiring in one pass. ## Quick Start Ask the AI to scaffold a new namespace named inventory with a Warehouse entity having address and timezone string fields.

Frequently Asked Questions about arch-scaffold-namespace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new namespace in a Python service architecture?▼

Invoke the skill with a namespace name, optionally followed by a first entity and its fields, for example `inventory Warehouse address:str`. It creates the manager interface, storage interfaces, Postgres and memory implementations, and wires everything into both roots.

What files does the namespace scaffold create?▼

It creates `__init__.py`, `README.md`, `manager.py`, `types/`, `impl/manager.py`, `storage/` with Postgres and memory implementations, and `storage/tables/` under `om/src/<root>/om/<ns>/`, then updates the storage root, manager root, and root unit tests.

Can I create an empty namespace without an entity?▼

Yes. Provide only the namespace name and the namespace is created empty and ready. A namespace with no entity has no API route; routes appear when the entity skill adds the first entity.

How does the scaffold handle Postgres session scoping?▼

Every storage method opens its session through the base's funnel, passing the call's scope by keyword such as `org_id`, `user_id`, or `identity_id`. This selects the login's engine and sets the transaction settings the database policies read.

When should I use the entity scaffold instead of the namespace scaffold?▼

Use the namespace scaffold when starting a new swimlane; it delegates to the entity skill automatically when a first entity is named. Use the entity skill directly when adding entities to an existing namespace.

Related Skills

Explore More Software Engineering Skills→
guilhermemarketingguilhermemarketing
59

component-flattening-analysis

Detect orphaned classes in root namespaces and generate component flattening plans.

Community
Advanced
wikimediawikimedia
4

add-ml-service

Scaffold and register LiftWing inference services in KServe helmfile and values manifests.

Official
Advanced
kagentikagenti

arch-review

Check code changes for architecture conformance across modules.

Official
Advanced
nicoarbelaeznicoarbelaez

web-design-guidelines

Identify UI code deviations from Web Interface Guidelines and output findings.

Community
Intermediate