메뉴
Orient quickly in this Deno Fresh 2 codebase — routing, the State/lang middleware, the Deno KV + typed-fixture data layer, islands, and where each kind of thing lives. Use before implementing a feature or when asked how the app is structured.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Implement a new feature in this Deno Fresh app the project's way — typed fixture → KV accessor + SEED_VERSION bump → server-rendered route/component → bilingual + sourced → deno task check. Use when building a new page, data type, or visual on the dashboard.
Review a change against this project's blocking gates and quality bar — government sources, SEED_VERSION bump, deno check, translation provenance (machine-draft flags), KPI defensibility. Use before opening a PR or when asked to review the current diff or a PR for this repo.
Add a new KPI to data/kpis.ts with every defensibility field the README requires (definition EN+ML, source, owner, refresh, target, comparators, direction, civic domain, owner dept). Use when adding any headline or tier-2 KPI.
Scan data/ fixtures for English-without-Malayalam parity gaps (titleMl, definitionMl, nameMl, summaryMl). Use when reviewing data changes, before PR, or when asked about bilingual coverage.
The project's contribution mechanics — formatting, linting, type-checking, testing, the source-policy gate, the opt-in pre-commit hook, and how to commit. Use when setting up the repo, before committing, or when asked how to run checks/tests here.
Find and vet a government source before adding any number to the dashboard. Use when sourcing a new KPI, comparator, Government Order, or Status-Paper figure — turns "I need a number" into "I have an official, linkable source".
| name | arch-discovery |
| description | Orient quickly in this Deno Fresh 2 codebase — routing, the State/lang middleware, the Deno KV + typed-fixture data layer, islands, and where each kind of thing lives. Use before implementing a feature or when asked how the app is structured. |
A fast map of kerala-gov-mission-control. Full detail is in
CLAUDE.md and
docs/data/data-model.md.
Deno Fresh 2, file-based routing in routes/. Each route exports a
handler (data-loading) and a default page component, wired by the define
helper from utils.ts. Server-rendered by default;
islands/ is the only client-side Preact.
| Need | Location |
|---|---|
| A page / endpoint | routes/** (e.g. routes/economy/index.tsx) |
| Client interactivity | islands/** (add only when genuinely needed) |
| Shared server components | components/** (KpiCard, MetricChart, Header) |
| Types | data/types.ts |
| Data fixtures | data/*.ts (typed arrays) |
| KV access layer | data/db.ts (get*/list*/put*, seed, SEED_VERSION) |
| i18n | data/lang.ts (Lang, t()), _middleware.ts sets ctx.state.lang |
| Styling tokens | static/styles.css (surface-card, eyebrow, metric-value) |
| Docs / specs | docs/** (specs/, data/, plans/) |
routes/_middleware.ts reads a lang cookie → ctx.state.lang ("en"|"ml") and
state.path. Components select name vs nameMl via t(lang, en, ml) or a
local pick(lang, en, ml).
data/)Fixtures in data/*.ts → seeded into Deno KV on cold start by
ensureSeeded(), keyed off ["meta","seed_version"]. KV layout is documented
at the top of data/db.ts. Critical: any fixture shape/content change
requires bumping SEED_VERSION or the site serves stale data. The GO ingest
pipeline (lib/ingest.ts, lib/cron.ts) writes a durable
["go_ingested"] mirror that survives reseeds.
deno fmt hook rewrites .ts/.tsx on save — re-read before
a second edit..env edits are blocked by a hook; edit by hand.deno task dev (localhost:8000). Grep routes/ for an existing page that does
something similar and mirror its handler/page shape. Use the Explore agent for
broad "where is X" sweeps.