AWARE: Open-Source Agentic Infrastructure for the AECO Industry

AWARE is an open-source agentic infrastructure targeting the AECO (Architecture, Engineering, Construction, Operation) industry. Its core paradigm shift is: Apps are text, AI is the runtime. Applications are stored as human-readable plain text files (.flo format), and AI directly executes these texts instead of being an auxiliary tool. This initiative aims to break the vendor lock-in and complexity of closed professional software in the AECO sector, empowering practitioners to regain control over their tools.

The AECO industry has long been dominated by complex, closed-source professional software with severe vendor lock-in. Users are tied to specific vendors' ecosystems, limiting flexibility and innovation. AWARE addresses this pain point by leveraging open standards and agent technology to create a vendor-agnostic, user-controlled infrastructure.

Key Design Truths

1. Apps are text: Stored as .flo plain text files, editable with any text editor.
2. AI is the runtime: AI understands and executes text-based apps directly, no compilation needed.
3. Open source as format: Plain text nature eliminates proprietary barriers, making open source inherent.
4. No vendor lock-in: No installers or walled gardens—users control tools and data.
5. AECO as entry point: Vertical focus on AECO, but infrastructure is generalizable.

Modular Components

• 00-vision: Vision docs (decalog.md, manifesto.md)
• 10-core: Core specs (agent, app, runtime contract)
• 20-agents: Ecological agents (engineering: Tekla/CSI API; architecture: Revit/AutoCAD; visualization: xeokit/Three.js; construction: Trimble Connect/ACC; cross-domain: Microsoft 365/Google Workspace)
• 30-apps: Reference apps (welded-to-tc.flo, qa-drawings-to-tekla.flo)
• 40-diagrams: Architecture visuals (Mermaid/Excalidraw)
• 50-research: Design notes and competitive analysis

Usage Steps

1. Install CLI: npm install -g @aware-aeco/cli (or curl/PowerShell alternatives)
2. Start AI Assistant: claude-code (or codex/opencode)
3. Define App: Describe needs in natural language (e.g., "Watch Tekla model for welded assemblies and upload drawings to Trimble Connect")
4. AI Generates Workflow: Creates .flo file (e.g., welded-to-tc.flo)
5. Execute: aware app run welded-to-tc

Technical Details

• Skill Generation: Supports --from-nuget (Revit/Tekla), --from-yard (SketchUp), --from-npm (Three.js), --from-openapi (REST APIs)
• Meta-primitives: aware-agent-builder (convert software to agents), aware-skill-builder (manage skills), html-report (render outputs)

v0 Completed

• Docs: Decalog, manifesto, core specs
• 7 reference agents, 58 production skills
• 2 reference apps, 3 meta-primitives
• Apache 2.0 license

v0.1 Roadmap

• aware CLI binary (runtime)
• Plugin generators for Claude Code/Codex/OpenCode
• Issue tracker, PR review process, contribution badges

Current codebase serves as documentation—contributors can port skills, write agents, and compose .flo apps before CLI release.

AWARE redefines software by turning apps into text and AI into runtime, offering a path to escape vendor lock-in for AECO. For practitioners, it enables natural language workflows to coordinate tools like Tekla/Revit. For developers, it promotes composable, auditable agent networks.

Ecosystem

• FloLess: Commercial visual canvas for AWARE apps (independent project)
• vercel-labs/skills: AWARE is compatible with this general skill installation规范

AWARE’s vision is grand but pragmatic, with 81k+ generated commands and 58 selected skills laying the foundation for an open, user-centric infrastructure.