.crustagent/vibecheck/skills/codebase-navigation/SKILL.md
# Sovereign Codebase Navigation This skill provides the "Deep Scan" blueprint of the ShellPlate ecosystem. Use it to orient yourself within the CrustCode©™ architecture. ## 🗺️ Project Blueprint ### 🏗️ Core Infrastructure - `server.js`: Main entry point for the Express backend. - `server/database.js`: SQLite schema initialization and connection management. - `vite.config.ts`: Frontend build and proxy configuration (Proxy: :5757 -> :6262). - `docker-compose.dev.yml`: Development environment c
npx skillsauth add acidgreenservers/clawchives .crustagent/vibecheck/skills/codebase-navigationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
This skill provides the "Deep Scan" blueprint of the ShellPlate ecosystem. Use it to orient yourself within the CrustCode©™ architecture.
server.js: Main entry point for the Express backend.server/database.js: SQLite schema initialization and connection management.vite.config.ts: Frontend build and proxy configuration (Proxy: :5757 -> :6262).docker-compose.dev.yml: Development environment containerization.server/)routes/: Express route definitions.
auth.js: User registration, login, and identity management.agents.js: Lobster Key (Agent Key) management.settings.js: User profile and appearance routes.services/: Core business logic (anchors of the truth).
agentService.js: Logic for generating and managing Lobster Keys.middleware/: Security and auth gates (e.g., requireAuth).src/)Architecture is feature-based. Cluster logic by feature area:
features/auth/: Registration, login, and ClawKey setup flows.features/settings/: Dashboard, profile configurations, and Lobster Key management.features/shell/: Main application frame, navigation, and landing pages.components/ui/: Shared Shadcn-based atomic components.services/: Frontend API clients (e.g., agentKeyService.ts).data/: Home of shellplate.db.data/backups/: Destination for scuttle-db-backup pinches.src/features/[feature]/.truthpack first, then touch server/routes/.server/services/.verified by vibecheck
<!-- vibecheck:context-engine:v2 -->development
# Feature Development Assistant ## Mission Statement You are an expert full-stack developer who builds complete features from concept to implementation using Desktop Commander's file management capabilities. Your role is to analyze existing codebases, design feature architecture, implement all necessary code, and integrate seamlessly with existing systems. ## Important: Multi-Chat Workflow **Feature development requires multiple chat sessions to avoid context limits and manage implementation c
development
The canonical ClawChives©™ agent integration skill. Full API reference for autonomous agents (Lobsters©™) to authenticate, manage bookmarks, folders, and integrate with the ClawChive bookmarking system.
development
# Truthpack Updater Skill ## When to Use Activate this skill whenever: - A new route is added to `server/routes/` - A new environment variable is introduced - The project structure or a feature cluster is modified - Security protocols or auth rules are updated ## Instructions 1. **Audit Phase**: Perform a full-codebase scan (`grep` or `list_dir`) to identify changes since the last truthpack sync. 2. **Atomic Updates**: Update the corresponding JSON file in `.crustagent/vibecheck/truthpack/`:
development
# Truthpack Lookup Skill ## When to Use Activate this skill BEFORE generating any code that: - Creates or modifies API routes - References environment variables - Touches authentication/authorization - Modifies API request/response shapes ## Instructions 1. Read `.crustagent/vibecheck/truthpack/routes.json` for verified API routes 2. Read `.crustagent/vibecheck/truthpack/env.json` for verified environment variables 3. Read `.crustagent/vibecheck/truthpack/auth.json` for verified auth rules 4.