Codvyn Build Stack Guide
Codvyn Build Stack Guide
CODVYN
Build Stack Series
Full-cycle product
[Link] execution inside one workspace.
| [Link]/codvyn
Plan, design, generate, and ship from a single IDE.
This guide is produced by Codvyn for developers who want to compress planning, design, code generation, and
delivery into a single uninterrupted IDE workflow. Every stage, from architecture sketching to production commits,
runs inside one window.
Contents
02 Tools Overview
05 Configuration Reference
[Link] | [Link]/codvyn
The Codvyn Integrated Build Stack collapses this spread. By combining Google Antigravity as the base IDE,
Claude Code as the AI code generation engine, and Pencil as the in-IDE design canvas, you get a single
workspace where every phase of product work happens without leaving the editor.
This is not about replacing deep specialists. It is about giving a solo developer, a small startup team, or any
developer who handles multiple roles a way to move from idea to shipped code faster and with less friction than
any fragmented toolchain allows.
02 Tools Overview
Before getting into setup, here is a precise summary of what each tool does inside this stack and how they relate to
one another.
Google Antigravity Base IDE and agent orchestration platform Gemini 3 Pro / Claude Sonnet 4.5
Claude Code Terminal-native agentic code generation and multi-file editingClaude Sonnet 4.5 / Opus 4.5
Pencil ([Link]) In-IDE vector design canvas with code export Claude Code via MCP
These three tools are designed to work together. Antigravity provides the orchestration layer. Claude Code
provides the agentic code intelligence. Pencil provides the visual design layer. Each communicates through
standard protocols: the VS Code extension API, the Model Context Protocol (MCP), and Claude Code's CLI
interface.
Google Antigravity
Google Antigravity is an agent-first IDE launched in November 2025, built on a fork of the open-source Visual
Studio Code codebase. It was announced alongside Gemini 3 and is designed around the concept of autonomous
agent management rather than traditional prompt-driven chat assistance.
The IDE provides two primary surfaces. The Editor view gives developers a familiar VS Code-style file tree, tab
system, and inline AI commands. The Agent Manager view functions as a mission control dashboard where you
can spawn, monitor, and coordinate multiple AI agents working on different tasks simultaneously, each in its own
workspace context.
Antigravity natively supports multiple AI models including Gemini 3 Pro, Claude Sonnet 4.5, Claude Opus 4.5, and
GPT-OSS. This gives developers model-level flexibility inside a single environment. Because it is a VS Code fork,
most existing VS Code extensions and key bindings transfer directly.
One important note: Antigravity uses the Open VSX extension registry rather than the Microsoft-proprietary VS
Code Marketplace. Most popular extensions are available on Open VSX, but you may need to install some as
VSIX files manually.
Claude Code
Claude Code is an agentic coding tool built by Anthropic. It lives in the terminal, understands your codebase, and
executes multi-file changes through natural language instructions. It was built for developers who want AI that acts
rather than just suggests.
The official VS Code extension for Claude Code integrates the CLI directly into the IDE. It creates a spark icon in
the sidebar, opens a dedicated panel, and renders code changes as inline diffs using the native VS Code diff
viewer. You accept or reject changes before they are written to disk. Context awareness is automatic: Claude
Code knows which files are open, what code is selected, and what the terminal has recently output.
Claude Code also supports sub-agents for parallel task execution, custom slash commands stored in
.claude/commands/, MCP server connections for external tool access, named session management with /rename
and --resume, and hooks that trigger on specific tool events.
Pencil ([Link])
Pencil is a developer-centric vector design platform that runs directly inside your IDE as a VS Code and Cursor
extension. It removes the traditional design-to-code handoff by storing design files as versioned .pen files inside
your Git repository alongside your code.
The design canvas is an infinite WebGL-powered vector surface rendered inside a dedicated IDE panel. You can
generate UI components from natural language prompts, import layouts from Figma via copy-paste, draw
manually, and convert any design to production-ready HTML, CSS, or React code. Pencil connects to Claude
Code through the Model Context Protocol, meaning Claude can read and write Pencil designs programmatically as
part of an agent workflow.
Pencil also supports sticky notes on canvas that can be converted into runnable prompts, multiplayer collaboration,
and bidirectional Figma integration for teams transitioning from traditional design workflows.
Install [Link]
02 Claude Code requires [Link] version 18 or higher. Verify your version by running node --version in
the terminal. If [Link] is not installed, download it from [Link] or use a version manager such as
nvm. This is a hard requirement; the Claude Code CLI will not function without it.
05 Configuration Reference
.claude/commands/ Custom slash commands as .md files with natural language instructions
.claude/rules/ Persistent rules that Claude follows across all sessions in this project
*.pen Pencil design files stored as versioned JSON in your Git repository
[Link] Project-level context file that Claude Code reads at session start
The [Link] file is particularly important. Place it at the root of your project and use it to document
architecture decisions, tech stack choices, naming conventions, and any constraints the AI should respect. Claude
Code reads this file automatically at the start of every session.
Deployment
06 With the codebase verified and tests passing, use Claude Code to handle deployment scripting. It can
write commit messages, create pull requests with descriptions generated from the actual code
changes, and produce deployment configuration files. All operations happen inside the Antigravity
terminal without switching to a separate tool.
Reference exact file names Say 'edit src/components/[Link]' rather than 'edit the header component'.
Ambiguous references cause Claude to guess.
Specify framework and Always include the framework and version: 'React 18 with TypeScript', '[Link] 14
version App Router'. AI behavior differs significantly between versions.
Limit scope per request One clear task per prompt produces better results than bundling multiple
changes. Broad prompts lead to over-generation and harder-to-review diffs.
Request explanation only Do not ask Claude to explain every step unless you need the explanation.
when needed Explanation adds tokens and slows execution. Ask only when debugging.
Include constraints explicitly State what you do not want as well as what you do. 'Do not modify the existing
auth logic' prevents unintended changes.
Use [Link] for Put architecture decisions, naming conventions, and stack choices in
persistent context [Link] so you do not have to repeat them in every prompt.
Validate before execution For any prompt that touches environment config, database, or auth, review the
diff carefully before accepting. These areas deserve extra scrutiny.
Conflict Resolution
When multiple agents modify overlapping files, Antigravity provides a visual conflict resolution interface with merge
guidance and rollback controls. Avoid pointing multiple agents at the same file simultaneously unless the conflict
resolution workflow is part of your intended process. For most workflows, assign each agent a clearly bounded
area of the codebase.
Practice Rationale
Commit after each approved Each accepted Claude Code change should correspond to a commit. Batching
diff many AI changes into one commit makes rollback harder.
Write descriptive commit Ask Claude Code to write commit messages: 'Write a commit message for
messages these changes.' It will generate messages based on the actual diff content.
Store .pen files in Git Pencil design files are JSON-based and version-controlled. Treat them the
same as code. This lets you roll back design and code together.
Review diffs before merging to Never merge AI-generated branches to main without manual diff review.
main Claude Code produces correct code most of the time but not always.
Use branches for feature work Each feature should be on its own branch. This lets you use agents to build
features in isolation and merge them cleanly.
Issue Resolution
Claude Code extension not Run the claude command from within the Antigravity integrated terminal.
appearing after install The extension auto-installs when it detects the CLI running inside the IDE.
If it still does not appear, run Developer: Reload Window from the
command palette.
Shift+Enter not working for Run /terminal-setup inside a Claude Code session. This configures the
multi-line prompts terminal keybinding automatically.
Pencil canvas not connecting to Ensure the Pencil extension is authenticated with Claude Code via the
Claude Code MCP server. Open the Pencil sidebar and follow the authentication flow.
Claude Code must be running in the same session.
Agent Manager not showing agent Switch between the Editor and Manager views using the view controls in
progress the top navigation bar. Check that you have an active workspace folder
open.
Extensions not available in Open Download the extension VSIX directly from the developer's site or the VS
VSX Code marketplace, then install via Extensions: Install from VSIX in the
command palette.
High memory usage with multiple Antigravity uses more RAM than standard VS Code, particularly when
agents running multiple agents with large file contexts. Close agents you are not
actively monitoring and restart the IDE if performance degrades
significantly.
IDE slow after long sessions Long conversation histories in Claude Code can increase memory usage.
Use /resume to continue a named session or start a fresh session and
reference the project context from [Link].
Output Description
*.pen files Versioned design files tracking the UI evolution of the product
Commit history A readable Git history where each commit maps to a design or code decision
Pull requests Documented PRs with descriptions written by Claude Code from actual diff
context
The measure of a successful workflow in this stack is not just whether the code works. It is whether the complete
record of decisions, from initial architecture through final design and implementation, is legible to any developer
who opens the repository later.
/stats View usage statistics including model history and usage streaks