# Assembly Hangar Core

Assembly Hangar is not just a normal SaaS tool. It is an operating system for
turning ideas and existing projects into structured, buildable, improvable
products. It supports founders, agencies, developers, clients and AI agents.

## What it must help users understand

- What the project is.
- What already exists.
- What is missing.
- What is broken.
- What should happen next.
- Which agent or human should do the work.
- What has changed.
- Whether the project is ready for staging or live.

## North Star

Assembly Hangar should become the system where a founder, agency, developer or
client can drop in an idea, document or existing project and get back a clear
diagnosis, product structure, module breakdown, task plan, agent-ready
instructions, build roadmap, UX structure, versioned implementation trail and a
clear path from idea to working product.

## The pyramid (overview)

1. Northstar (goal, problem, promise)
2. Audience, users and roles
3. Problem, use cases and scenarios
4. Feature map (modules and features)
5. Requirements and acceptance criteria
6. UX, screens and navigation
7. Data, database and permissions
8. Integrations, APIs and automations
9. Architecture and technical blueprint
10. Planning, tasks and dependencies
11. Agent execution and work packages
12. Code review, tests and quality
13. Versioning, releases and changelog

Groups: steps 1-3 Direction & goal; steps 4-9 Design & build-up; steps 10-11
Execution; steps 12-13 Quality & release.

Core principle: Understand first. Structure second. Design third. Build fourth.
Validate fifth. Document last.

## Main system capabilities

- Project intake: accept ideas, briefings, documents, codebases and feature requests; capture the original goal and current status.
- Project diagnosis: analyze what exists, detect broken flows, confusing UI, missing settings, duplication and technical debt.
- Pyramid mapping: place every project and page on the 13-step pyramid so each part has a reason to exist.
- Information architecture: a logical menu, grouped modules and a clear settings area.
- UX and layout improvement: calm, professional pages that move from overview to detail to action.
- Agent task system: turn work into specific, testable tasks for AI agents.
- Codebase adoption: understand and improve existing projects instead of rebuilding blindly.
- Versioning and validation: every meaningful change is documented, validated and reversible.

## Core workflows

- New idea intake to structured project plan.
- Customer briefing to product pyramid.
- Existing codebase to diagnosis to improvement plan.
- Feature request to impact analysis to tasks to implementation.
- UX problem to analysis to layout improvement to validation.
- Agent task to execution to review to changelog.
- Code change to test to staging to live; failed change to rollback.

## The role of AI agents

Agents act as product architect, system analyst, UX reviewer, technical
planner, implementation agent, QA assistant and documentation maintainer, not
only as coders. Agents never add features blindly; every change must support the
pyramid, the product purpose or a real user workflow.

## What Assembly Hangar must feel like

A calm, intelligent operating system for building and improving products.