Skip to content
cccskills
FreePublished on GitHub

arch

Navigate FlexPrice’s codebase using its architecture maps, dependency graphs, hotspot notes, and flow documents. Trace a feature across layers and async systems, assess likely change impact, and identify documentation that should be updated after structural edits.

OriginalShow the original description

FlexPrice repo architecture — docs/ layering, deps, hotspots, flows, Graphify. Say arch, repo architecture, FLEXPRICE structure, onboarding codebase.

flexprice/flexprice6,876 stars(GitHub 6,876 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Getting oriented in the FlexPrice codebase
  • Tracing a feature across code layers
  • Assessing impact before a refactor
  • Updating architecture notes after structural changes

Files included (1)

  • SKILL.md3.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

arch — repository architecture

Use when navigating cmd/, internal/, ent/ (billing, metering, Temporal, Kafka, integrations).

Other repos: repo-architecture-intelligence (~/.cursor/skills/repo-architecture-intelligence/SKILL.md).

Sibling skills: README (apitest, devenv, godev, openapi, pr, gh, compose).

Canonical documentation map

DocPurpose
docs/REPO_MAP.mdDirectory census, deployment modes, major systems
docs/ARCHITECTURE.mdPrinciples, infra choices, layering, conventions
docs/DEPENDENCY_GRAPH.mdFan-in/out, messaging DAG, coupling notes
docs/HOTSPOTS.mdLarge files & structural risks
docs/FLOWS/*.mdEnd-to-end narratives for critical paths

Rule: Prefer these artifacts over improvised mental models. If docs drift from code during your change, patch the relevant markdown.

How to analyze architecture quickly

  1. Identify deployment surface — cmd/server/main.go + deployment.mode. Determine whether edits affect API-only paths, Kafka consumers, or Temporal workers (registerRouterHandlers & startTemporalWorker branches).
  2. Locate the bounded context — map feature → domain package (internal/domain/<ctx>) → repository impl (repository/ent vs repository/clickhouse) → service (internal/ee/service/<file>) → handler (internal/api/v1).
  3. Check async edges — list Kafka topics touched (search config keys under internal/config) and Temporal workflow names (internal/temporal/workflows).
  4. Assess coupling — if you need half of ServiceParams, consider narrowing new code’s dependencies deliberately.

How to reason about dependencies

  • Follow canonical direction: handlers → services → (domain interfaces + repos/integrations) → storage/IO (see diagram in docs/DEPENDENCY_GRAPH.md).
  • Watch logical cycles: Temporal registration reconstructs some services independently of Fx (internal/temporal/registration.go).
  • Question globals: prefer replacing new uses of GetGlobalTemporalService with injected interfaces when editing those call sites safely.

How to persist repository memory

After meaningful structural edits:

Change typeUpdate
New package / major subsystemREPO_MAP.md (+ ARCHITECTURE.md boundaries if philosophical)
New topic/consumer or couplingDEPENDENCY_GRAPH.md + YAML pointer
Emerging risk/god file growthHOTSPOTS.md entry
Flow behavior changeRelevant docs/FLOWS/<name>.md

Treat docs as durable context for future automation and onboarding.

How to refactor safely

  1. Freeze scope — isolate one bounded context or one pipeline stage.
  2. Add or extend characterization tests closest to seams you cut (heavy services deserve targeted tests despite size).
  3. Avoid splitting multi-thousand-line files blindly — extract cohesive types/helpers with stable interfaces (subscription.go, invoice.go, billing.go).
  4. For schema changes — always make generate-ent + deliberate migration rollout; annotate operational risk if backfill jobs required.
  5. For messaging — verify consumer group uniqueness and DLQ configuration when adjusting handler semantics (internal/pubsub/router).

Anti-patterns to flag during review

  • Domain importing repositories or Gin types.
  • Handlers querying Ent directly.
  • Silent topic renames without consumer coordination.
  • New global singletons hiding dependencies.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

apitest

FreeSummary

Run local HTTP API checks with a staged workflow: confirm the environment, gather credentials interactively, probe endpoints with curl, and record status codes and response excerpts. For large suites, it can divide independent endpoint groups among workers and merge their results.

  • Smoke-checking a local API
  • Testing authenticated endpoints with curl
  • Organizing checks across many endpoints
flexprice/flexprice6.9KUpdated Oct 29, 2026

compose

FreeSummary

Use this skill to set up or manage FlexPrice’s local Docker environment. It provides commands to start and stop services, launch Kafka UI, and follow application logs while troubleshooting.

  • Setting up the local development environment
  • Starting or stopping FlexPrice services
  • Opening Kafka UI during development
flexprice/flexprice6.9KUpdated Oct 29, 2026

context-sync

FreeSummary

Use this skill to check whether repository AGENTS.md context files have fallen behind code changes. It compares tracked file ownership with Git revisions, prepares focused update bundles for affected layers, and advances sync markers after the context is updated.

  • Checking whether AGENTS.md files are stale
  • Refreshing context after code changes
  • Updating one layer’s context file
flexprice/flexprice6.9KUpdated Oct 29, 2026

devenv

FreeSummary

Plan a local development setup by mapping which services run in Docker Compose and which use hosted endpoints such as RDS or managed Kafka. The skill guides environment configuration, service checks, migrations, and choosing an application mode.

  • Preparing a hybrid local and hosted development setup
  • Starting an API, consumer, or Temporal worker locally
  • Checking environment settings before migrations
flexprice/flexprice6.9KUpdated Oct 29, 2026

gh

FreeSummary

Use the GitHub CLI to review pull requests and issues, inspect CI check results and failed logs, and prepare a pull request with a summary and test plan. The skill also outlines the repository review steps before creation.

  • Reviewing a pull request or issue from the CLI
  • Finding the cause of a failed CI check
  • Preparing and creating a pull request
flexprice/flexprice6.9KUpdated Oct 29, 2026

godev

FreeSummary

Format Go code, check it with go vet, and run focused race tests or the full project test suite. The skill guides a repeatable verification flow after code changes, using Makefile targets when available.

  • Checking Go code after a change
  • Running race tests on edited packages
  • Running the full test suite
flexprice/flexprice6.9KUpdated Oct 29, 2026

See all skills by flexprice

Report a problem with this skill