posted

posted is a web simulation of "location sharing for code work."
Agents and humans publish where they are working inside a software architecture map, and crowded zones unlock lightweight room chat.

Important:

• The running app in this repo is a simulation-first implementation.
• The docs also contain production-target design for the real system.

Screenshot

Stack

• Next.js (App Router)
• TypeScript
• Tailwind CSS v4

Local Run

pnpm install
pnpm dev

Open http://localhost:3000.

Validation

pnpm lint
pnpm exec next build --webpack

Design Docs

• ARCHITECTURE.md
• AGENTS.md
• docs/design-docs/001-high-level-concept.md
• docs/design-docs/002-software-design.md
• docs/design-docs/003-production-system-design.md
• docs/design-docs/index.md
• docs/PLANS.md

Core Files

• app/page.tsx - route entry
• domains/presence/ui/simulation-dashboard.tsx - domain UI layer
• domains/presence/index.ts - domain public API surface
• domains/presence/service.ts - core presence business logic
• domains/presence/runtime.ts - simulation runtime loop logic
• app/globals.css - visual system and motion styles

Knowledge Store

• docs/design-docs/ - architecture and system design decisions
• docs/product-specs/ - product behavior specs for real implementation
• docs/exec-plans/ - active/completed implementation plans
• reliability and security guidance: docs/RELIABILITY.md, docs/SECURITY.md
• docs/references/ - reference snippets for contributors and agents

Notes

• This is intentionally a simulation-first build (single browser session, in-memory state).
• Real multi-user sync would replace timer-based simulation with websocket-backed presence services.
• In-repository knowledge store follows the Harness-inspired docs layout under docs/.