championswimmer/architecture
.agents/skills/architecture/SKILL.md
Understand onepixel runtime architecture, host-based app dispatch, and redirect analytics flow before changing behavior across routes/controllers/db.
$ install --global
skillsauthnpx skillsauth add championswimmer/onepixel_backend architectureInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 3, 2026, 10:28 PM8.4s1 file scanned
SKILL.md
- name:
- architecture
- description:
- Understand onepixel runtime architecture, host-based app dispatch, and redirect analytics flow before changing behavior across routes/controllers/db.
Architecture Skill
Use this skill when implementing features that cross app startup, routing, controller behavior, or data boundaries.
Runtime model
- Process entrypoint:
src/main.go. - Startup initializes three singleton data clients:
- app DB (
db.GetAppDB) - events DB (
db.GetEventsDB) - GeoIP DB (
db.GetGeoIPDB)
- app DB (
- HTTP entry app dispatches by
Hostheader:ADMIN_SITE_HOST->server.CreateAdminAppMAIN_SITE_HOST->server.CreateMainApp
Data boundaries
- App DB stores users, URL groups, URLs.
- Events DB stores redirect analytics events.
- DB singletons and migrations are in
src/db/init.go.
Redirect and analytics flow
- Redirect handlers are in
src/routes/redirect/redirect.go. - Redirect resolution logs events asynchronously using
EventsController.LogRedirectAsync. - Event enrichment includes GeoIP and PostHog emission (
src/utils/posthog/posthog_client.go).
API layering pattern
- Preserve this stack for new/changed endpoints:
- route handler -> parser (
src/server/parsers) -> validator (src/server/validators) -> controller -> DTO response
- route handler -> parser (
Related Skills
championswimmer/test
testing
VerifiedTrustedCommunity
Run onepixel unit and e2e tests with correct env setup, coverage artifacts, and troubleshooting guidance for GeoIP/network-related failures.
186SKILL.mdUpdated Apr 3, 2026
championswimmer/database
data-ai
VerifiedTrustedCommunity
Understand onepixel database topology by environment, data ownership across app/events stores, and initialization/migration behavior.
186SKILL.mdUpdated Apr 3, 2026
championswimmer/conventions
development
VerifiedTrustedCommunity
Apply onepixel repository conventions for env loading, DB backend selection, auth locals, error payloads, and shortcode semantics.
186SKILL.mdUpdated Apr 3, 2026
championswimmer/build
development
VerifiedTrustedCommunity
Build and run onepixel binaries, generate Swagger docs when needed, and produce cross-platform release artifacts.
186SKILL.mdUpdated Apr 3, 2026