FirstLook

Verified Meaning. At First Look.

FirstLook adds & surfaces verified, persistent meaning for code artifacts at the point of interaction — helping developers and AI start informed before the deep dive begins.

Know what you're looking at. Understand its purpose and domain. Build familiarity before analysis — without modifying the code.

Context may vary. Meaning should not.

🧭 Developer Empathy in Code Exploration

Developer productivity helps developers work faster.

Developer Empathy helps them start better.

Unfamiliar code often begins with an icebreaker: cryptic file names, unknown domains, inherited systems, scattered documentation, or knowledge that lives with experienced team members.

FirstLook acknowledges that first-contact friction.

Instead of requiring developers to begin from zero, search for context elsewhere, or immediately ask AI to rediscover what may already be known, FirstLook surfaces a stable, verified starting point where the code is encountered.

Get oriented. Build familiarity. Spark curiosity. Then deep dive with greater confidence.

🎬 Watch 2-min Demo

See how FirstLook brings meaning into the developer's existing working surface.

📸 FirstLook in Action

🔍 Meaning on Hover

Get oriented instantly by surfacing known meaning without leaving the Explorer.

🧭 Control Panel & Coverage

Explore governed meaning, track coverage, manage understanding, and identify gaps across the codebase.

✍️ Add Meaning

Add or refine structured meaning for an artifact without modifying the underlying source code.

🧠 Local Insights — Your Understanding, In Context

Capture discoveries and personal notes as you work — directly associated with the artifact where they matter.

✨ What FirstLook Does

• Surfaces known meaning where code is encountered
• Provides a verified, persistent starting point before deeper exploration
• Makes meaning available through hover, FirstLook Explorer, and the Meaning Panel
• Supports governed baseline meaning alongside personalized local meaning and insights
• Tracks meaning coverage and identifies knowledge gaps
• Supports AI-assisted meaning generation using your preferred AI
• Does all of this without modifying the underlying code

FirstLook does not need to replace documentation, AI analysis, or existing knowledge sources.

They can help create the meaning.

FirstLook makes that meaning available at first look.

💡 Quick Start

1. Right-click any file in Explorer
2. Select FirstLook: Add / Edit Local Meaning
3. Look for ✓ or L indicators
4. Hover for a quick orientation or click to explore the meaning

👉 FirstLook works immediately with local meaning — no enterprise baseline is required to get started.

🧠 Your Meaning Layers

Governed / Baseline Meaning

Verified organizational meaning that provides a stable starting point for understanding an artifact.

Baseline meaning can be loaded independently of the source code and governed as organizational knowledge evolves.

Local Meaning

Developer-defined meaning associated with a specific artifact.

Use it to personalize or supplement the governed baseline without changing the code.

Local Insights

Capture what you discover during the deep dive.

Local Insights keep your notes and evolving understanding associated with the actual artifact, creating a living record of what you learn over time.

⚙️ How It Works

1. Bring existing understanding into FirstLook — manually, from structured files, or with AI assistance
2. Explore the codebase through the FirstLook Explorer
3. Surface meaning through indicators, hover, and the Meaning Panel
4. Add or refine local meaning as needed
5. Capture Local Insights as understanding grows
6. Track meaning coverage and identify gaps

The meaning source can evolve.

The goal remains simple:

Surface what is already known where the developer encounters the code.

✨ AI-assisted Meaning — Preview

AI can help derive meaning. FirstLook gives that meaning a persistent place in the developer workflow.

Use AI-assisted meaning draft to:

1. Generate a structured FirstLook prompt
2. Send it to your preferred AI assistant
3. Receive structured meaning as JSON
4. Bring the result back into FirstLook
5. Review and apply the generated fields

This allows AI-generated understanding to become an input to FirstLook rather than requiring the same basic context to be rediscovered repeatedly.

Native AI integration is planned for a future release.

🔐 Enterprise-friendly by Design

• No external API calls required
• No telemetry
• No source-code modification
• Local-first data handling
• Separation between governed meaning and personal insights

FirstLook is designed to support environments where organizational knowledge needs greater stability, control, and traceability.

📂 Data Format

Governed baseline meaning can currently be loaded using:

• CSV
• Excel (XLSX)

Typical fields include:

• artifact_name
• descriptor
• type
• domain
• purpose
• insights

🚀 Current Capabilities

• FirstLook Explorer for meaning-aware code exploration
• Explorer indicators (✓ / L)
• Hover-based orientation
• Dedicated Meaning Panel
• Governed baseline meaning
• Local meaning
• Local Insights
• Meaning coverage visibility
• AI-assisted ingestion
• Configurable panel behavior

🛠️ Roadmap

• Native AI integration
• Multi-provider AI support
• Governed meaning and SME validation workflows
• Team-level sharing and synchronization
• Additional enterprise meaning sources
• Meaning surfaces beyond the IDE

⚠️ Early Version

FirstLook is an early release (v0.1.x).

The implementation will evolve, but the underlying question is intentionally simple:

Why should every developer — or AI agent — have to start from zero when encountering code that an organization already understands?

Feedback, criticism, and real-world use cases are welcome.

Meaning Control™

FirstLook is an implementation of the broader Meaning Control™ vision — exploring how derived knowledge can become persistent, governed, and available at the point where humans and machines need it.

For code exploration, that means introducing another dimension alongside developer productivity:

Developer Empathy

Acknowledge the first-contact experience.

Give developers a familiar, informed starting point.

Then let them do the real work.

FirstLook isn't where you understand everything.
It's where you shouldn't have to begin knowing nothing.

Enjoy using FirstLook 🚀