Local Dev & Architecture

Developer Guide

Local setup, project structure, coding conventions, and integration notes.

Local Setup

Ensure Node.js 20+ is installed

npm install

npm run build

npm run test

Project Structure

the Forge server — runtime entrypoint

src/forge/modules/ — module domains: governance, safety, context-engine, agent, production, healing, architecture

SKIA Forge IDE — IDE-facing integration surface

docs/ — product documentation set

public/ — static assets and HTML pages

Development Workflow

Implement scoped changes in src/forge/modules/*.

Run npm run lint, npm run typecheck, npm run test.

Validate integration routes and control-plane behaviour.

Coding Conventions

Use typed request/response schemas for all API surfaces

Keep policy checks explicit and test-covered

Prefer additive changes over implicit behaviour changes

Integration Notes

Forge can run with SKIA integration enabled or disabled. Adapter paths should fail clearly and return structured errors when upstream contracts are unavailable.