Semantic Intent
The philosophy behind PACE and all related projects.
Overview
Semantic Intent is a design philosophy that prioritizes understanding user intent through natural language and letting AI guide users to outcomes.
Core belief: Software should understand what users mean, not just what they type.
Philosophy
Three Principles
1. Clarity Before Code
Write clear intent before implementation:
❌ Bad:
function x(a, b) {
return a.filter(y => y.z === b)
}
✅ Good:
// Find all products matching the given category
function findProductsByCategory(products, category) {
return products.filter(product => product.category === category)
}Clarity in naming, comments, and structure.
2. Intent Before Implementation
Understand the "why" before the "how":
❌ Bad:
"Build a product grid"
✅ Good:
"Help users discover the right product through conversation,
because browsing 50 options causes decision paralysis"Intent drives design. Implementation follows.
3. Natural Language as Source of Truth
Users express intent in natural language:
Traditional:
User → UI controls → Filters → Results
Semantic Intent:
User → Natural language → AI interpretation → GuidanceThe most natural interface is conversation.
Manifestations
PACE Pattern
Application: Guide-first product discovery
Intent: Users shouldn't browse; they should be guided
Implementation:
- Conversational interface
- AI guide
- Adaptive responses
- Executive summary
StratIQX
Application: Strategic intelligence reports
Intent: Users need insights, not just data
Implementation:
- Natural language questions
- AI-generated analysis
- Adaptive depth (3 tiers)
- Visual support
PlayIQX
Application: Playbook analysis
Intent: Complex strategies need decomposition
Implementation:
- Playbook decomposition
- AI-guided planning
- Visual frameworks
- Implementation roadmaps
Design Patterns
Pattern 1: Conversational Discovery
Instead of navigation:
Traditional:
Menu → Submenu → Category → Product → Details
Semantic Intent:
"What do you need?" → AI surfaces options → Dialogue → DecisionPattern 2: Adaptive Complexity
Match user expertise:
Beginner: "Think of it like..."
Expert: "Implements JSON-RPC 2.0..."Pattern 3: Progressive Disclosure
Start simple, add depth on request:
Initial: High-level summary
On request: Detailed explanation
On deeper request: Technical specsPattern 4: Meta-Awareness
Show users what the system knows:
Executive Summary:
- What we've discussed
- What you're interested in
- Where you are in the journey
- What to do nextCore Values
1. User Agency
Users control the conversation. AI guides but doesn't dictate.
2. Transparency
Show how AI arrived at recommendations. No black boxes.
3. Efficiency
Respect user time. Be concise. Be actionable.
4. Adaptability
One size doesn't fit all. Adapt to context and expertise.
5. Clarity
Simple language. Clear explanations. No jargon (unless user is expert).
Technical Expression
Code Philosophy
// ✅ Semantic Intent style
function greetUser(user) {
const expertise = detectExpertise(user.messages)
const greeting = adaptGreeting(expertise)
return greeting
}
// ❌ Traditional style
function greet(u) {
return "Hello"
}Code should read like a conversation.
Architecture Philosophy
Simple → Understandable → Maintainable → ExtensibleNot:
Complex → Clever → Hard to maintain → Technical debtInfluence
Inspired By
Natural Language Processing
- Understanding human intent
- Context awareness
- Semantic parsing
Conversational AI
- Claude (Anthropic)
- GPT (OpenAI)
- Dialogue systems
Human-Computer Interaction
- Don Norman's "Design of Everyday Things"
- Alan Cooper's "About Face"
- Steve Krug's "Don't Make Me Think"
Biological Systems
- Cormorant foraging (PACE)
- Natural intelligence
- Adaptive behavior
Future
Vision
Software that understands intent becomes invisible.
Users don't think about "using the app." They think about accomplishing their goal. The software becomes a guide, not a tool.
Next Steps
1. Multi-Modal Intent
- Voice + text + gesture
- Cross-device continuity
- Ambient computing
2. Proactive Intelligence
- Anticipate needs
- Suggest before asked
- Learn from behavior
3. Collaborative AI
- AI as teammate
- Shared understanding
- Joint problem-solving
Projects
All Semantic Intent projects:
- PACE Pattern — Guide-first UX
- PACE.js — JavaScript framework
- MillPond — MCP storefront
- StratIQX — Strategic intelligence
- PlayIQX — Playbook analysis
Community
Values
- Openness — Open source, open research
- Collaboration — Built together
- Learning — Share knowledge
- Impact — Solve real problems
Get Involved
- Build with Semantic Intent principles
- Share your implementations
- Contribute to projects
- Spread the philosophy
Contact
- Email: [email protected]
- GitHub: github.com/semanticintent
Clarity before code. Intent before implementation. Natural language as source of truth. ✨