NarmaForge

From idea to verified deployment.

NarmaForge is an all-in-one software delivery, deep architecture, and multi-system design suite with 19 routed skills, thin adapters, and a local standard-library Python runtime. It supports dual operating modes: autonomous Autopilot Mode (agents/autopilot.md) and targeted Manual Mode across all skills.

The suite preserves three distinct, protected sovereign design foundations—NarmaForge Cupertino Foundation (apple-hig-design), NarmaForge Tonal Expressive Foundation (google-material3), and NarmaForge Indic Vernacular Foundation (sarvam-indic-design)—ensuring design identities are never overridden or homogenized into generic templates.

Install by host

Run the installer from this package directory. It installs every available skill by default, copies the shared runtime, and adds the selected host adapter. Choose a curated set with --bundle core|design|full, or use --skills with a comma-separated custom list; the two selectors are mutually exclusive. Use --dry-run to inspect the plan first.

Example focused installs:

python scripts/install.py --host generic --project PROJECT_PATH --bundle core --dry-run
python scripts/install.py --host generic --project PROJECT_PATH --bundle design
python scripts/install.py --host generic --project PROJECT_PATH --skills color,components

All five named hosts are packaged in this release; see the respective adapter README files.

Quick start

These command forms work in Bash and PowerShell. Quote project paths when they contain spaces.

Use the task ID returned by init with --help-documented runtime commands. For a trivial one-file fix, invoke the skill directly without creating a ledger. The runtime is available at python .narmaforge/bin/orchestrator.py --workspace . COMMAND ....

Task state is stored under .narmaforge/tasks/.

Dual operating modes

1. Autopilot Mode: Run agents/autopilot.md for end-to-end autonomous delivery (Discovery ➔ Architecture ➔ Design Foundation ➔ Anti-Slop Audit ➔ Bounded Implementation ➔ Verification ➔ Approval Handoff).
2. Manual Mode: Directly invoke any individual NarmaForge skill on demand.

Included skills

Sovereign Design Foundations (Protected)

• Apple HIG & Swift provides the NarmaForge Cupertino foundation: optical typography, materials, physics, spatial computing, navigation patterns, and Swift architecture.
• Google Material 3 provides the NarmaForge Tonal Expressive foundation: dynamic HCT extraction, 5-tier surface containers, shape scale, and motion physics.
• Sarvam Indic Design provides the NarmaForge Indic Vernacular foundation: Terracotta + Tech Indigo, Indic multi-script typography (Devanagari, Tamil, Telugu, etc.), and sub-250ms voice streaming UI.

Deep Architecture & Craft Gating

• Improve Codebase Architecture audits software entropy, detects shallow modules, and refactors into deep modules with simple interfaces.
• Hyperframes CLI authors deterministic HTML5, CSS, and GSAP timeline video animations with headless rendering.
• Frontend Design enforces anti-slop visual craft with 4-6 color palettes, expressive typography pairing, and anti-default self-critique.
• UIzze Design enforces 6-state coverage (ideal, loading, empty, error, partial, optimistic) and concentric radius geometry.
• Web Design Guidelines audits accessibility, 44px hit targets, GPU-accelerated motion, and tabular numeric alignment.

Core Delivery & Workflows

• NarmaForge routes the software-delivery sequence, foundation protection, and safety rules.
• Discover creates an explicit, schema-checked project brief.
• Stack records architecture decisions with current official-source checks.
• Theme select, color, and design tokens build the visual foundation.
• Components and page patterns route reusable UI and screen structures.
• UI review provides a static linter and a human review checklist.
• Quality routes testing, code review, and lightweight security/dependency checks; ship prepares CI, releases, documentation, operations, and budgets without deploying.
• scripts/diff_review.py gives compact mechanical prompts from a local git diff.

Multi-Stack Support

NarmaForge design tokens and code recipes are completely language-agnostic. All systems provide universal --narma-* design tokens mapped side-by-side to:

• Web & React: Tailwind CSS plugins and CSS custom properties
• Flutter: ThemeData and CupertinoThemeData specifications
• React Native: Scaled StyleSheet token objects
• Jetpack Compose: MaterialTheme and Compose ColorSchemes
• SwiftUI: Dynamic color assets, optical typography, and declarative view modifiers

Limitations & Safety

• Python 3.10+ is needed for the ledger/runtime.
• The runtime is not an OS sandbox or authorization service. Checks inherit host permissions.
• NarmaForge contains no network, deployment, credential, or purchase features. Do not perform external or destructive actions without explicit user approval.
• Never claim checks, security reviews, deployment, or completion without evidence. List skipped checks, risks, and remaining work.

Project records

• Architecture, permission matrix, and runtime API
• Contributor guide, security policy, and threat model
• Package tree and architecture decision
• Release preparation checklist
• Research, capability comparison, and design decisions

License

NarmaForge is MIT licensed; see LICENSE.