One
Make Your Ideas Real. Build Apps, Websites and AI Agents with Plain English with Astro, React, Shadcn and Cloudflare
Install / Use
/learn @one-ie/OneAbout this skill
Quality Score
0/100
Category
Development & EngineeringSupported Platforms
Claude Code
Claude Desktop
Cursor
OpenAI Codex
README
ONE
Every intelligent system needs a coherent model of reality.
██████╗ ███╗ ██╗███████╗
██╔═══██╗████╗ ██║██╔════╝
██║ ██║██╔██╗ ██║█████╗
██║ ██║██║╚██╗██║██╔══╝
╚██████╔╝██║ ╚████║███████╗
╚═════╝ ╚═╝ ╚═══╝╚══════╝
Make Your Ideas Real
https://one.ie • npx oneie
ONE Ontology gives AI agents—and the humans who direct them—a complete, scalable architecture for understanding who owns what, who can do what, what happened, and what it all means.
📦 Quick Start
# Option 1: Bootstrap new project
npx oneie # Install
claude # Start Claude Code
/one
# Option 2: Clone and develop
git clone https://github.com/one-ie/one
cd web
bun install
bun dev
Development Commands:
# Claude Code
claude # Start Claude
/one # Run /one Claude command
# Frontend
cd web/
bun run dev # localhost:4321
bun run build # Production build
bunx astro check # Type checking
# Testing
cd web/
bun test # All tests
🎬 Demo
See ONE in action:
Video Demo: Watch on one.ie
A complete walkthrough showing how to build AI agents, applications, and your audience using the 6-dimension ontology.
ONE
Make your ideas real
Model reality in six core dimensions and map everything to them.
┌─────────────────────────────────────────────────────────────┐
│ Groups → People → Things → Connections → Events → Knowledge │
│ │
│ Everything flows through these six dimensions. │
│ Everything scales without schema changes. │
│ Everything is queryable, composable, and intelligent. │
└─────────────────────────────────────────────────────────────┘
Every single thing in ONE exists within one of these 6 dimensions:
┌──────────────────────────────────────────────────────────────┐
│ 1. GROUPS │
│ Multi-tenant isolation with hierarchical nesting - who owns │
│ what at group level (friend circles → DAOs → governments) │
└──────────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────────┐
│ 2. PEOPLE │
│ Authorization & governance - platform owner, group owners │
└──────────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────────┐
│ 3. THINGS │
│ Every "thing" - users, agents, content, tokens, courses │
└──────────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────────┐
│ 4. CONNECTIONS │
│ Every relationship - owns, follows, taught_by, powers │
└──────────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────────┐
│ 5. EVENTS │
│ Every action - purchased, created, viewed, completed │
└──────────────────────────────────────────────────────────────┘
↓
┌──────────────────────────────────────────────────────────────┐
│ 6. KNOWLEDGE │
│ Labels + chunks + vectors powering RAG & search │
└──────────────────────────────────────────────────────────────┘
The Universal Interface (How Technology Implements the Ontology):
┌─────────────────────────────────────────────────────────────────────┐
│ LAYER 1: UNIVERSAL INTERFACE │
│ (The 6-Dimension DSL) │
├─────────────────────────────────────────────────────────────────────┤
│ groups → Hierarchical containers (friend circles → governments)│
│ people → Authorization & governance (who can do what) │
│ things → All entities (66 types: user, product, course...) │
│ connections → All relationships (25 types: owns, purchased...) │
│ events → All actions (67 types: created, updated, logged...) │
│ knowledge → AI understanding (embeddings, search, RAG) │
│ │
│ This layer NEVER changes. It models reality. │
└──────────────────┬──────────────────────────────────────────────────┘
│
↓ Technology changes, ontology stays the same
### 1. 👥 Groups
**Hierarchical containers that organize people and things**
Groups can nest infinitely—from intimate friend circles to massive organizations. Each group owns its own graph of people, things, connections, events, and knowledge, creating perfect isolation at any scale.
**6 Group Types:**
- `friend_circle` - Small, intimate groups
- `business` - Commercial organizations
- `community` - Interest-based collectives
- `dao` - Token-governed groups
- `government` - Public institutions
- `organization` - Generic groups
**URL-Based Creation:**
one.ie/group/cooldao → creates "cooldao" group one.ie/group/cooldao/treasury → creates nested "treasury" group one.ie/group/emmas-birthday → creates "emmas-birthday" group
**Hierarchical Nesting Example:**
groups/acme-corp (business) ├─ groups/engineering (organization) │ ├─ groups/backend-team (organization) │ └─ groups/frontend-team (organization) ├─ groups/marketing (organization) └─ groups/sales (organization)
groups/emmas-friends (friend_circle) ├─ groups/birthday-party (friend_circle) └─ groups/game-night (friend_circle)
groups/cool-dao (dao) ├─ groups/treasury (dao) └─ groups/governance (dao)
---
### 2. 🙋 People
**Authorization & governance - WHO can do what**
People are the prime movers. Every decision, transaction, and relationship traces back to human intent. People link to organizations through membership connections, creating clear authorization chains.
**4 Roles:**
- `platform_owner` - Platform-level control
- `org_owner` - Organization-level control
- `org_user` - Organization member
- `customer` - End user
**Properties:**
- Identity (name, email, wallet)
- Authentication credentials
- Role within organization
- Permissions and authorization
- Preferences and settings
**Why it matters:**
- ✓ Human authorization required
- ✓ Clear governance
- ✓ Audit trails
- ✓ Intent and accountability
- ✓ AI serves people, not the other way around
---
### 3. 📦 Things
**Entities - WHAT exists in your system**
Things are discrete entities with properties, types, and states. They can be agents, products, audiences, tokens, mandates, contracts—anything you need to model. Every thing belongs to exactly one group.
**66 Thing Types** organized in categories:
**Core:**
- `creator`, `audience_member`, `workspace`, `organization_settings`
**Agents:**
- `intelligence_agent`, `business_agent`, `personal_assistant`, `data_analyst`, `writer`, `researcher`, `moderator`, `customer_support`, `sales_rep`, `code_reviewer`, `qa_tester`, `task_automator`
**Content:**
- `video_content`, `text_content`, `audio_content`, `image_content`, `course`, `curriculum`, `module`, `lesson`, `quiz`, `certificate`, `podcast`, `newsletter`, `live_stream`, `blog_post`
**Products:**
- `token`, `nft`, `digital_product`, `offer`, `subscription_tier`, `bundle`, `access_pass`
**Community:**
- `community`, `forum`, `discussion`, `announcement`, `poll`
**Knowledge:**
- `knowledge_base`, `knowledge_chunk`, `topic`, `recommendation`, `insight`, `summary`
**Platform:**
- `ai_clone`, `voice_clone`, `personality_profile`, `mandate`, `delegation`, `workflow`, `automation`, `integration`, `webhook`
**Business:**
- `lead`, `deal`, `invoice`, `payment_method`, `payout_config`
---
### 4. 🔗 Connections
**Relationships - HOW things relate to each other**
Connections are first-class relationships with their own properties. They express ownership, membership, governance, authorization, dependencies, transactions, and more. Connections make the implicit explicit.
**25 Connection Types:**
**Ownership & Authorization:**
- `owns` - Ownership relationship
- `can_read` - Read access
- `can_write` - Write access
- `can_execute` - Execution permission
**Governance:**
- `governed_by` - Governed by mandate
- `delegated_to` - Delegation chain
- `member_of` - Membership
**Content & Knowledge:**
- `authored` - Created content
- `taught_by` - Teaching relationship
- `enrolled_in` - Course enrollment
- `contains` - Hierarchical containment
**Social:**
- `following` - Social following
- `subscribed_to` - Subscription
- `holds_tokens` - Token ownership
**Consolidated Types (with metadata):**
- `transacted` - Financial transactions (metadata.protocol: stripe | sui | blockchain)
- `communicated` - Messages/interactions (metadata.channel: email | chat | voice)
- `delegated` - Delegated authority (metadata.permissions: [...])
- `governed` - Governance (metadata.constraints: [...])
- `powered` - Dependency (metadata.config: {...})
- `related` - Generic relationship (metadata.relationshipType: custom)
- `licensed_to` - Licensing (metadata.terms: {...})
---
### 5. ⚡ Events
**Actions - WHAT happened, when, and why**
Events are immutable records of every action in your system. They create an audit trail, enable time-travel queries, feed analytics, and power learning loops. Events are the memory
