digirati-co-uk/architecture-bootstrapping
.agents/skills/architecture-bootstrapping/SKILL.md
Map and modify Madoc TS startup, server composition, routing setup, and SSR entrypoints. Use when tracing request flow, adding top-level middleware, wiring new services at boot, or debugging startup/SSR integration for services/madoc-ts.
$ install --global
skillsauthnpx skillsauth add digirati-co-uk/madoc-platform architecture-bootstrappingInstall 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 16, 2026, 3:52 PM4.4s2 files scanned
SKILL.md
- name:
- architecture-bootstrapping
- description:
- Map and modify Madoc TS startup, server composition, routing setup, and SSR entrypoints. Use when tracing request flow, adding top-level middleware, wiring new services at boot, or debugging startup/SSR integration for services/madoc-ts.
Architecture & Bootstrapping (Madoc TS)
Goal
Explain how Madoc TS starts, how servers and routers are composed, and where SSR is wired in so agents can safely trace or change app boot flow.
Scope
- App startup and server wiring
- Router construction and top-level middleware
- SSR integration points and HTML templates
Non-scope
- Feature-level route handlers
- Business logic in extensions or repositories
- UI component implementation
Key Entry Points
services/madoc-ts/src/index.tsservices/madoc-ts/src/server.tsservices/madoc-ts/src/app.tsservices/madoc-ts/src/router.tsservices/madoc-ts/src/paths.tsservices/madoc-ts/src/config.tsservices/madoc-ts/src/routes/frontend/site-frontend.tsservices/madoc-ts/src/routes/frontend/admin-frontend.tsservices/madoc-ts/src/site.htmlservices/madoc-ts/src/admin.html
Quick Start Workflow
- Read
services/madoc-ts/src/index.tsto locate the primary startup path. - Follow through
services/madoc-ts/src/server.tsandservices/madoc-ts/src/app.tsto understand server creation and middleware ordering. - Inspect
services/madoc-ts/src/router.tsfor route assembly and registration conventions. - Review
services/madoc-ts/src/paths.tsandservices/madoc-ts/src/config.tsfor runtime configuration, defaults, and env wiring. - For SSR, inspect
services/madoc-ts/src/routes/frontend/site-frontend.tsandservices/madoc-ts/src/routes/frontend/admin-frontend.tsplusservices/madoc-ts/src/site.htmlandservices/madoc-ts/src/admin.htmltemplates.
Common Tasks
- Add top-level middleware
- Trace startup failures and misconfiguration
- Add a new top-level server capability
- Update SSR template injection points
Workflow Guidance
- Start with the top-level entrypoint and move inward. Do not jump directly to route handlers.
- Keep middleware ordering in mind. The earliest registered middleware will affect all routes.
- When changing SSR, verify both the server route handler and the HTML template tokens (
<!--ssr-head-->,<!--ssr-outlet-->).
Useful Local Searches
rg -n "createServer|listen|app" services/madoc-ts/srcrg -n "router|routes" services/madoc-ts/src/router.tsrg -n "ssr" services/madoc-ts/src/routes/frontend services/madoc-ts/src/*.html
Pitfalls
- Breaking middleware ordering and auth guard placement
- Changing SSR output without matching template tokens
- Introducing config defaults that diverge between environments
Suggested Checks
- Boot smoke test for server startup
- One admin page SSR request
- One site page SSR request
Related Skills
digirati-co-uk/utility-core
tools
VerifiedTrustedCommunity
Work on Madoc TS shared utility helpers (JWT, metadata, errors, IIIF helpers, auth helpers). Use when changing core utility functions or shared helpers in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/types-schemas
development
VerifiedTrustedCommunity
Work on Madoc TS shared type definitions and schema contracts. Use when updating TypeScript types, JSON schema shapes, or cross-layer data contracts in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/tasks-automation
tools
VerifiedTrustedCommunity
Understand and extend Madoc TS task automation, including bots and task-related extensions. Use when adding task automation, bot behavior, or task metadata resolution in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/ssr-site
development
VerifiedTrustedCommunity
Work on Madoc TS site SSR pipeline, HTML template injection, and site render data wiring. Use when changing site SSR behavior, template tokens, or site SSR data wiring in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026