codebase-navigation

Traces request flows and responsibilities across the Axentra Bun monorepo workspace.

Updated Sep 16, 2026
One-click install
npx skills add https://github.com/PT-Perkasa-Pilar-Utama/axentra --skill codebase-navigation-pt-perkasa-pilar-utama
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-navigation
Source: https://github.com/PT-Perkasa-Pilar-Utama/axentra/tree/main/.claude/skills/codebase-navigation
Command: npx skills add https://github.com/PT-Perkasa-Pilar-Utama/axentra --skill codebase-navigation-pt-perkasa-pilar-utama

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Navigating a multi-package Bun monorepo is error-prone when you guess file locations or copy conventions from unrelated projects. This Skill provides a verified map of the Axentra workspace and a repeatable procedure for tracing any request from route to test. ## Core Features & Use Cases - Workspace Map: Locates the Hono API, React/Vite UI, Worker, and shared packages (db, config, queue, storage, observability) by responsibility. - Request Tracing: Follows a route from apps/api/src/app.ts through handler, service, repository, schema, and tests. - UI Tracing: Follows React Router to feature view, presenter, and API client for frontend changes. - Use Case: When asked to modify an API endpoint, use this Skill to find the mounted route, its service layer, shared response types, and existing tests before editing anything. ## Quick Start Ask the assistant to trace where a specific API route is implemented and which files own its handler, schema, and tests.

Frequently Asked Questions about codebase-navigation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trace an API request in a Hono monorepo?▼

Start at the route mounted in apps/api/src/app.ts, then follow its handler, service, repository, and schema. Inspect shared response types and request context, and finish by locating the tests for the route and its service.

How to find where a React feature is implemented in a Vite app?▼

Follow React Router to the feature view, then its presenter and API client under apps/web/src. This traces the full path from URL to backend call without guessing file locations.

Where does shared code live in a Bun workspace monorepo?▼

In Axentra, shared contracts live in packages/shared/src, PostgreSQL/Drizzle code in packages/db/src, and config in packages/config/src. Queue, storage, and observability each have their own package under packages/.

Can I add business features to foundation infrastructure modules?▼

No. Foundation modules are infrastructure-only until a task card approves business scope. Never copy conventions from another project or assume a file exists; verify against the actual repository first.

What should I run after implementing changes in this codebase?▼

Run bun run complete-check after implementation. This validates the change against the workspace's checks before handoff.