japa-bugs-hunters
JapaConnect comprehensive bug hunter. On load it presents a menu — (1) a frontend URL or page name of any of the 6 SvelteKit apps (+ Flutter mobile), (2) a backend API route, (3-9) a whole surface (ba
SKILL.md.claude/skills/japa-bugs-hunters/SKILL.md
GitHubJapaConnect Bug Hunter
This skill turns the JapaConnect Bug Hunter's Guide (.jeos/.ai/skills/japa-bugs-hunters.md, the
canonical bug taxonomy) into an actionable, self-fixing workflow. The Guide is the taxonomy of bugs;
this skill is the engine that applies it.
Authoritative business truth: the .jeos/ repo (JEOS v1.23.1) — JEOS.md, sections/* (102
numbered sections, 01–102, covering v1 features §§01–59 and v2 features §§60–102), conventions/*
(api-routes-catalog, permission-key-naming, system-settings-catalog, valkey-keys-catalog,
asynq-tasks, api-response-format, database-migration-naming, feature-flag-naming,
svelte-component-patterns), the 110 ADRs (ADR-001–110), the 8 roadmap files (incl.
ROADMAP-V2.md planning index and ROADMAP-TOOLS.md), the geo-aware tool pattern
(.jeos/skills/geo-aware-tool-pattern.md), and AGENTS.md 18 Golden Rules. Any
code that contradicts JEOS is a bug even if it compiles.
v2 scope (JEOS v1.14.0–v1.23.1): sections 60–102 and ADRs 061–110 add AI Persona System (§68,
ADR-068), JapaBot RAG Knowledge Layer (§69, ADR-069), Visa Checklist (§70), Readiness Assessment
(§71), Cost of Living (§72), Scholarship Finder (§73), Remittance Tracker (§74, ADR-075), AI
Content Studio (§75, ADR-076), Participation Orchestration (§76, ADR-077), Referral (§60,
ADR-078), Self-Serve Ads (§61, ADR-079), Newsletter (§62, ADR-080), Jobs Board (§63, ADR-081),
Gamification (§64, ADR-082), Content Import (§65, ADR-083), Advanced Analytics (§66, ADR-084),
Travel Search (§67, ADR-085), Flutter Mobile (§77, ADR-067/074), Tools Web Surface (§78,
ADR-086), 11 V2 community features (§§79–89, §98 — Community Story Wall §79/ADR-087,
Destination Wiki §80/ADR-088, Scam Alert Board §81/ADR-089, Japa Planning Groups §82/ADR-090,
Visa Timeline Tracker §83/ADR-091, Community Digest Widget §84/ADR-092, Mutual Aid Board
§85/ADR-093, Community Calendar §86/ADR-094, Japa Stage Profiles §87/ADR-095, Ask-an-Expat AMA
§88/ADR-096, Achievement Feed §89/ADR-097, Service Directory §98/ADR-106), 12 V2 functional
tools (§§90–97, §§99–101 — Visa Route Comparison §90/ADR-098, Embassy Appointment Alerter
§91/ADR-099, Arrival Checklist §92/ADR-100, Visa Processing Time Tracker §93/ADR-101,
Professional Credential Checker §94/ADR-102, CV/Resume Formatter §95/ADR-103, Housing Guide
§96/ADR-104, Attestation Guide §97/ADR-105, Language Test Hub §99/ADR-107, Tax Calculator
§100/ADR-108, Diaspora Community Locator §101/ADR-109), and Mentorship Matching (§102,
ADR-110). Three new architecture principles apply: P9 (one backend, multiple client surfaces —
ADR-086), P10 (synthetic activity always flagged internally via is_bot/is_synthetic —
ADR-068/077), P11 (reuse over new infrastructure — ADR-063). The geo-aware tool pattern
(.jeos/skills/geo-aware-tool-pattern.md) governs all §§79–101 features: destination country is
the primary data axis, no tool hardcodes any specific nationality, all list/lookup endpoints
accept ?dest= as primary filter, and the destination country selector is always the first UI
input. ADR-088 universal AI content generation applies to all admin-managed content tables
across §§79–101: standard columns (ai_generated, ai_model, hitl_reviewed_by), AI generation
via the existing §20 AI Gateway, and mandatory HITL review before publish.
Critical Environment Notes (Always Add these to context)
These must be followed every time this skill is loaded:
Always use Playwright whenever a page URL or link is supplied. This is mandatory for all SvelteKit frontend testing, screenshot capture, and browser interaction. Never skip browser automation. Exception: the Flutter mobile app (
apps/mobile/) is not a browser target — useflutter analyze,flutter test, andflutter runon an emulator/simulator instead.Chrome is already installed on this system. Do NOT attempt to install Chromium — it is unnecessary and will waste time. Use the existing Chrome installation.
Playwright is already installed on this system. Do NOT run
npx playwright installor any similar installation command. The system is pre-configured and ready to use.Super admin credentials:
admin@japa.to/Admin123!(fromJC_SEED_ADMIN_EMAIL/JC_SEED_ADMIN_PASSWORDin.env) — use these when login is required to test authenticated pages or admin features.Always use
bunto start dev servers, install packages, or run any app commands. Never usenpmorpnpm— this project uses Bun as its runtime and package manager. When a server or app is down and needs to be started for testing, usebun dev(orbun run dev) in the relevant app directory, nevernpm run devorpnpm dev.Always ask the user before closing the browser. Before running
agent-browser closeor ending the browser session, ask the user to verify whether the issue is fully resolved or if there are remaining bugs to fix. Never close the browser unilaterally — the user may want to test additional scenarios or see the fix in action first.
Step 0 — On Load: Present the Menu
Immediately after this skill loads, use the question tool to present these options and let the
user pick exactly one. Use multiple: false.
header: "Target"
question: "What do you want to bug-hunt and fix?"
options:
- label: "Frontend URL / page" (option 1)
A specific page on any of the 6 SvelteKit apps (main, admin, control, learn, docs, tools) or
the Flutter mobile app (`apps/mobile/`). For SvelteKit apps the agent loads Playwright and
tests the page. For Flutter mobile the agent uses `flutter analyze` + `flutter test` + the
`jc-mobile-*` skills; Playwright does not apply.
- label: "Backend API / route" (option 2)
A specific /api/v1/* route or handler. The agent reviews/debugs it for bugs, unimplemented
features, incomplete wiring, missing migrations, RBAC, etc., and fixes them.
- label: "Backend (whole)" (option 3)
Audit + fix the entire Go API monolith against the Guide.
- label: "Main app" (option 4)
Audit + fix apps/main (port 3000, SSR) against the Guide.
- label: "Control panel" (option 5)
Audit + fix apps/control (port 3002, SPA) against the Guide.
- label: "Admin panel" (option 6)
Audit + fix apps/admin (port 3001, SPA) against the Guide.
- label: "Docs site" (option 7)
Audit + fix apps/docs (port 3004, SSR) against the Guide.
- label: "Learn platform" (option 8)
Audit + fix apps/academy (port 3003, SSR) against the Guide.
- label: "Tools pages" (option 9)
Audit + fix the in-app tool pages on apps/main (/tools/{tool}) — the former
apps/tools surface was consolidated into main (ADR-086 superseded).
- label: "Feature name (from ./internal)" (option 10)
A specific feature in the ./internal folder (e.g. forum, like, bookmark, ai, affiliate,
persona, rag, remittance, studio, newsletter, gamification, story_wall, wiki, scam_alert,
planning_group, visa_timeline, digest, mutual_aid, calendar, mentorship, visa_routes,
embassy, arrival_checklist, credential_checker, cv_formatter, housing_guide,
attestation_guide, service_directory, language_test_hub, tax_calculator,
community_locator). The agent asks the user to input the feature name, then runs a full
cross-stack audit (backend + frontend across all 6 SvelteKit apps + Flutter mobile + JEOS spec)
for that feature, categorizes bugs by class, and saves findings to
./.jeos/audit/<feature_name>-audit.md.
- label: "Fix feature audit findings" (option 11)
Apply fixes to the bugs recorded in ./.jeos/audit/<feature_name>-audit.md (produced by Option
10). The agent asks for the feature name, reads the audit file, and fixes each open bug using
the standard japa-bugs-hunters workflow (Options 1–9 fix rules). Every successfully fixed bug
is marked **already implemented** in the audit file so it is never re-fixed.
After the user answers, read .jeos/.ai/skills/japa-bugs-hunters.md in full, then execute the
matching workflow below. Never skip reading the Guide — it contains the section-number
references you must cite in fixes and reports.
If the user picks Option 10: immediately ask them to input the feature name (a folder under
./internal, e.g. forum, like, bookmark, ai, affiliate, persona, rag, remittance,
studio, story_wall, wiki, scam_alert, planning_group, mentorship). Validate that
./internal/<feature_name> exists before proceeding; if it does not, list the available
./internal/* subdirectories and ask the user to pick one. Then execute the
Option 10 — Feature Audit workflow below.
If the user picks Option 11: immediately ask them to input the feature name. Validate that
./.jeos/audit/<feature_name>-audit.md exists; if it does not, list every file in ./.jeos/audit/
and ask the user to pick one (or suggest running Option 10 first to produce the audit). Then execute
the Option 11 — Fix Feature Audit Findings workflow below.
Shortcut triggers:
Any of these skip the menu entirely. The phrase is case-insensitive and the quotes are optional
(e.g. /japa-bugs-hunters "audit forum", /japa-bugs-hunters fix /dashboard/overview). The verb
audit vs fix only changes the workflow for features (Option 10 = audit-only, Option 11 =
fix-only); for every other target both verbs trigger that target's combined audit+fix workflow.
Routing rules (evaluate in order, first match wins):
- Feature audit/fix —
/japa-bugs-hunters "audit [feature_name]"or/japa-bugs-hunters "fix [feature_name]"where[feature_name]is a folder under./internal(e.g.forum,like,bookmark,ai,affiliate,persona,rag,remittance,studio,story_wall,wiki,scam_alert,planning_group,mentorship).audit [feature_name]→ Option 10 — Feature Audit (read-only, writes./.jeos/audit/<feature_name>-audit.md). Validate./internal/<feature_name>exists; if not, list./internal/*subdirectories and ask the user to pick one.fix [feature_name]→ Option 11 — Fix Feature Audit Findings. Validate./.jeos/audit/<feature_name>-audit.mdexists; if not, list every file in./.jeos/audit/and offer to run Option 10 first.
- Backend API / route —
/japa-bugs-hunters "audit /api/v1/<route>"or/japa-bugs-hunters "fix /api/v1/<route>"(any target starting with/api/v1/, or a handler identifier likeforum.CreatePost) → Option 2 — Backend API / Route. - Frontend URL / page —
/japa-bugs-hunters "audit <url-or-path>"or/japa-bugs-hunters "fix <url-or-path>"where the target is a URL (http://localhost:3000/...,https://admin.japa.to/...) or a frontend path (/dashboard/overview,/forum/threads,/settings/profile) → Option 1 — Frontend URL / Page. Resolve the app from the URL/path per Option 1's app-resolution rules. - Whole surface —
/japa-bugs-hunters "audit <surface>"or/japa-bugs-hunters "fix <surface>"where<surface>is one of the surface keywords:backend→ Option 3 — Backend (whole)main→ Option 4 — Main appcontrol→ Option 5 — Control paneladmin→ Option 6 — Admin paneldocs→ Option 7 — Docs sitelearn→ Option 8 — Learn platformtools→ Option 9 — Tools pages (apps/main /tools/*)
Ambiguity fallback: if a target could match multiple rules (e.g. a single word that is neither a
known ./internal/ feature nor a surface keyword), ask the user to clarify with the menu. When the
verb is omitted entirely (e.g. /japa-bugs-hunters forum), treat it as audit for features and as
the combined audit+fix for all other targets.
Option 1 — Frontend URL / Page
Trigger
- User picks Option 1 from the menu, OR
- User invokes
/japa-bugs-hunters "audit <url-or-path>"or/japa-bugs-hunters "fix <url-or-path>"with a URL or frontend path (see routing rule 3).
Resolve the app from the URL (or ask which app if only a page name is given):
localhost:3000/japa.to→ main (SSR, ADR-058 shell)localhost:3001/admin.*→ admin (SPA)localhost:3002/control.*→ control (SPA)localhost:3003/learn.*→ learn (SSR, ADR-060 lesson-player exception)localhost:3004/docs.*→ docs (SSR, ADR-060 nav-tree/TOC)localhost:3005/tools.*→ tools (SSR, ADR-086 hub/single-tool host-detection shell, §78)- Flutter
apps/mobile(or a mobile screen name like/feed,/forum/threads,/profile) → mobile (Dart,japaconnect_coreclient, §77/ADR-074/ADR-113 — Playwright does not apply)
If the target is
apps/mobile/, first check the directory exists. If it does not, the mobile app is not yet implemented — report this and stop. If it exists, load the relevantjc-mobile-*skill (develop/debug/audit/refactor) for the fix type.For SvelteKit apps, launch Playwright (use the
webapp-testingskill /playwright-cli). Start the dev server if not running (bun devin the app dir). Open the URL, capture console errors, network failures (esp. 4xx/5xx on/api/v1/*), layout/visual screenshots at desktop + mobile widths, and hydration warnings. For the tools app, additionally verify the host-detection shell mode: hit the hub domain (all tools) and a per-tool domain/subdomain (single-tool shell, tool-specific branding, no cross-tool nav) per ADR-086/§78.For
apps/mobile/, follow the Flutter mobile verification workflow instead:- Run
flutter doctorfor the target platform. - Run
flutter pub getinapps/mobile/andpackages/japaconnect_core/. - Run
flutter analyzeandflutter test. - If a visual/interactive fix is needed and the platform is available, launch an Android emulator
(
flutter run) or iOS Simulator (flutter run -d ios, macOS only). Verify the screen renders without overflow and the relevant API calls succeed. - Check
X-Device-IdandAuthorizationheaders are present on API calls. - For backend bugs, switch to
jc-backend-debugand fix the Go code.
- Run
Filter the Guide to the page. Apply the
[FE]and[BOTH]sections relevant to the page type: §1 (forms/nav/calc), §2 (UI/UX, dark mode, LayerChart), §3 (API calls, 401 loop, contract drift), §6 (Svelte 4 anti-patterns), §7 (i18n), §16 (SSR/hydration), §17 (admin/control SPA), §18 (i18n language packs), §21 (stub/missing UI), §23 (form data), §27 (Rule 16 hardcoded data), §36 (learning routes), §78 (tools host-detection shell), §77 (Flutter mobile app) and ADR-074 (mobile screen contract, device-scoped JWT, push notifications,X-Device-Idheader). For v2 tool pages also check §70–§73 (visa checklist / readiness / cost of living / scholarship finder UIs) and §74 (remittance UI). For v2 community feature pages (§§79–89, §98) check the geo-aware country selector is first input, no hardcoded nationality,?dest=filter on list endpoints. For v2 functional tool pages (§§90–97, §§99–101) check ADR-088 universal AI content generation columns (ai_generated,ai_model,hitl_reviewed_by) and HITL review gate before publish. For mentorship pages (§102) check the 60/40 keyword+pgvector match scoring display and DM auto-open on connection accept.Fix frontend bugs in place. For SvelteKit apps: Svelte 5 runes, Bits UI, LayerChart 2.0.1,
var(--chart-*)theming,$t()i18n, no raw hex, noexport let/$:/on:. For Flutter mobile: Riverpod (or the project's state solution), sharedjapaconnect_corewidgets, nosetStatesoup, no rawhttpin feature code, no access token influtter_secure_storage. For the tools app, respect the hub vs single-tool shell contract — a single-tool domain must NOT render cross-tool nav.If a bug needs the backend, fix the backend too — do not stop at the frontend. This includes:
- A route the page calls that does not exist → add it (see Option 2 workflow): pick the owning
sections/*file (v1 §§01–59 or v2 §§60–102), add the route toconventions/api-routes-catalog.md, implement handler→service→store with sqlc, add any migration, wire RBAC node + CSRF, return the standard error envelope. - An unwired/incomplete handler (stub, no-op, missing CRUD leg) → implement it fully.
- Missing RBAC node / permission cache invalidation, Valkey key (must be
jc:-prefixed + tenant-scoped + cataloged), Asynq task (must be in asynq-tasks catalog — 95 tasks total), system_settings key (187 keys total), or migration → add/fix per JEOS. - GDPR gap if the page surfaces PII → cover the table in erasure.
- v2-specific: missing
is_synthetictagging on persona activity (P10), missing high-stakes HITL gate on immigration/financial content, missing RAG embedding on publish, persona backing account notis_bot, content studio job not idempotent onstudio_job_id→ fix per the v2 Mandatory Patterns (see Option 2 step 3). For §§79–102 features: missing geo-aware?dest=filter on list endpoints, missing ADR-088 AI generation columns on admin-managed content tables, missing HITL review gate before publish, missing feature-flag 404 (not 403) when disabled, hardcoded nationality in tool UI → fix per the v2 Community/Tool Mandatory Patterns (see Option 2 step 4).
- A route the page calls that does not exist → add it (see Option 2 workflow): pick the owning
Re-run Playwright on the page; iterate until 100% working (no console errors, all network calls succeed, layout correct light+dark, i18n present, no hydration mismatch). For the tools app, verify both shell modes render correctly. For Flutter mobile, re-run
flutter analyzeandflutter test, and verify on an emulator/simulator that the screen renders without overflow and the API contract is honored.
Option 2 — Backend API / Route
Trigger
- User picks Option 2 from the menu, OR
- User invokes
/japa-bugs-hunters "audit /api/v1/<route>"or/japa-bugs-hunters "fix /api/v1/<route>"with a backend route or handler identifier (see routing rule 2).
- Locate the handler in
internal/(match route → package →server.go/handlers). Confirm it is registered in chi and matchesconventions/api-routes-catalog.md(~819 routes: ~475 v1 + ~344 v2). - Review the full vertical slice: route → handler → service → store (sqlc) → migration.
- Apply the
[BE]and[BOTH]sections: §1.3 (calc), §3 (API contract, error envelope, idempotency), §4 (queries, Valkey tenant-scoping, N+1, pgvector), §5 (SQLi, CSRF, RBAC, secrets), §6.2/6.3 (Go logic, nil deref), §8 (migrations, circular FK, sqlc regen), §9 (RBAC/multi-tenancy), §10 (Asynq catalog + idempotency + DLQ), §11 (WebSocket), §12 (Meilisearch tenant filter), §13 (payments/ wallet ledger +SET NX EX), §14 (content_hash, soft-delete, Tiptap sanitize), §15 (GDPR erasure coverage), §19 (AIai.context.*default-off, budget), §21 (stub/incomplete handler, missing CRUD leg), §22 (the 18 Golden Rules), §24 (field/data types), §25 (custom fields), §26 (RBAC CRUD + wiring). v2 sections §§60–102 add feature-specific bug classes — apply the ones matching the route's feature (see the v2 Mandatory Patterns below). - v2 Mandatory Patterns (JEOS v1.16.0–v1.23.1) — check these when the route belongs to a v2
feature, treat a violation as a bug:
- AI Personas (§68/ADR-068): persona provisioning is transactional (account + byline +
ai_personasconfig in one txn);users.is_botis permanent on the backing account; the internalis_bot/ai_personasflag is always true even when public disclosure is off (P10);is_syntheticis set onplatform_eventsfor persona activity and excluded from real-metric materialized views; the high-stakes HITL gate (immigration/financial/grants/health) is unconditional and cannot be bypassed via config. - RAG Knowledge Layer (§69/ADR-069):
content_embeddingsuses upsert (not insert) on publish/edit via the existingcontent:generate_embeddingtask; TipTap JSON is extracted to plain text before embedding; source-tier (editorial vs community) is labelled; retrieval is top-k at/ai/chattime. - AI Content Studio (§75/ADR-076):
studio_jobsis idempotent onstudio_job_id; AI fills custom field values as structured output; all drafts enter the §22content_reviewsqueue;studio.auto_publish_typesmay only auto-publish low-stakes types — immigration/financial guide categories permanently require review. - Participation Orchestration (§76/ADR-077): dispatched actions use the
is_botbacking account's RBAC; a run-lock Valkey key prevents concurrentpersona:run_activity; daily counters guard against budget overflow;autonomousvsqueuedautonomy is honoured; high-stakes gate overridesautonomous. - Remittance Tracker (§74/ADR-075):
remittance_providers.api_configis encrypted at rest;remittance_rateshistory is append-only (never UPDATE/DELETE); the three tasks (remittance:fetch_rates/check_alerts/prune_old_rates) are registered in the catalog; does NOT touch §58 fixed credit-economy rates. - Newsletter (§62/ADR-080): unsubscribe tokens are single-use; bounce/complaint webhooks update subscriber status; marketing email uses the ADR-015 provider abstraction; GDPR one-click unsubscribe is honoured.
- Referral (§60/ADR-078): first-click 30-day attribution; fraud controls per ADR-026; per-period cap enforced; Credits reward via §28 ledger (idempotent).
- Self-Serve Ads (§61/ADR-079): verified-org gate; upfront credit payment via §17/§28; creative
review via §22 queue;
ads:refund_campaign_creditson rejection. - Jobs Board (§63/ADR-081):
job_listingcontent type via §14;jobs:expire_listingsdaily task; on-platform apply via §06 forms. - Gamification (§64/ADR-082): evaluated inside
wallet:process_activity_event; Valkey leaderboard;gamification:expire_challengestask; counter overflow guarded. - Tools Web Surface (§78/ADR-086): host detection reads per-tool
system_settingsdomain keys; CORSallowed_originsextended per active domain; same binary serves hub + single-tool shells. - Geo-Aware Tool Pattern (§§79–101,
.jeos/skills/geo-aware-tool-pattern.md): destination country is the primary data axis — no tool hardcodes any specific nationality; all list/lookup endpoints accept?dest=as primary filter; destination country selector is always the first UI input; schema includesdestination_country_id; feature-flag middleware returns 404 (not 403) when a feature is disabled (ADR-042); RBAC seed migration uses000NNN_seed_{feature_domain}_rbac_nodes.sqlnaming; admin list endpoints must have filter + sort + paginate (no infinite scroll). - ADR-088 Universal AI Content Generation (§§79–101): all admin-managed content tables carry
standard columns (
ai_generated,ai_model,hitl_reviewed_by,ai_generated_at); AI generation goes through the existing §20 AI Gateway (no new AI infrastructure — P11); HITL review is mandatory before publish;is_japabot_indexedcomputed column added for RAG-retrievable content (§69 JapaBot Indexability Pattern). - Community Story Wall (§79/ADR-087): reuses
contentstable withcontent_type = 'story'story_metaextension table; filterable by origin/destination/visa/profession; admin verification viastory.verifyRBAC node.
- Destination Wiki (§80/ADR-088):
wiki_pages+wiki_revisionstables; reputation-gated editing (wiki.min_reputation_to_editsetting); revision approval workflow;jc:wiki_edit_lockValkey key prevents concurrent edits. - Scam Alert Board (§81/ADR-089):
scam_reports+scam_alert_subscriptionstables; anonymous reports gated byscam_alert.anonymous_reportsfeature flag; admin pin/verify viascam_alert.review/scam_alert.pinRBAC. - Japa Planning Groups (§82/ADR-090): 4 new tables (
planning_groups,_members,_milestones,_checkins); group size 5–20;planning_group:expireandplanning_group:checkin_reminderAsynq tasks; reuses WebSocket/DM infrastructure (§10/§48). - Visa Timeline Tracker (§83/ADR-091):
visa_timelines+_milestonestables +visa_processing_statsmaterialized view;visa_timeline:refresh_stats(nightly) andvisa_timeline:prompt_update(weekly) tasks; anonymous sharing for crowd-sourced stats; feeds data to Visa Route Comparison (§90) and Processing Time Tracker (§93). - Community Digest Widget (§84/ADR-092):
digest_editionstable;digest:generate(weekly) anddigest:send_email(on publish) tasks; reuses Newsletter infrastructure (§62);jc:digest_draftValkey key. - Mutual Aid Board (§85/ADR-093):
mutual_aid_poststable; Needs/Offers/Skill Swaps;mutual_aid:expire(nightly) task; non-commercial only; reuses DM system (§48). - Community Calendar (§86/ADR-094):
calendar_entries+_subscriptions+_savestables;calendar:staleness_check(nightly) andcalendar:send_reminders(daily) tasks; moderator-verified entries. - Japa Stage Profiles (§87/ADR-095): adds columns to
user_profiles(no new table); seven-stage state machine;profile.japa_stage.editRBAC node; reuses JapaBot (§69) and Readiness Assessment (§71). - Ask-an-Expat AMA (§88/ADR-096): adds
ama_configJSONB column toforum_threads(no new table); reuses Forum Engine (§08) withthread_type = 'ama';jc:ama_activeValkey key;ama_cooldown_dayssetting. - Achievement Feed (§89/ADR-097): reuses
contentswithcontent_type = 'achievement'+achievement_metaextension; reuses Reactions (§29) and Japa Stage (§87). - Visa Route Comparison (§90/ADR-098):
visa_routestable; reuses Generic Comparison System (§30);visa_routes:check_links(weekly) task; links to Visa Checklist (§70) and Timeline Tracker (§83). - Embassy Appointment Alerter (§91/ADR-099):
appointment_alerts+monitored_embassiestables;embassy:poll_{slug}(per embassy) andembassy:dispatch_alerts(critical queue) tasks;jc:embassy_availValkey key; premium tier via §17 Payment. - Arrival Checklist (§92/ADR-100):
arrival_checklist_guides+_itemstables; reuseschecklist_progressfrom §70; links to Community Locator (§101) and Scam Alert Board (§81). - Visa Processing Time Tracker (§93/ADR-101): UI surface of §83 (no new tables); SEO pages for aggregate stats; reuses all §83 infrastructure.
- Professional Credential Checker (§94/ADR-102):
credential_professions+_pathways+_community_notestables; reuses AI Core/HITL (§20) and Tools Web Surface (§78);credentials:check_linkstask. - CV/Resume Formatter (§95/ADR-103):
cv_standards+cv_format_sessionstables; reuses AI Gateway (§20);jc:cv_quotaValkey key for monthly quota;cv_formatter.use(member+),cv_formatter.unlimited(premium+) RBAC tiering;cv_format:processandcv_format_sessions:purgetasks. - Housing Guide (§96/ADR-104):
housing_guidestable; reuses Scam Alert Board (§81) and Cost of Living (§72); AI-generated with HITL. - Attestation Guide (§97/ADR-105):
attestation_pathways+_community_updatestables; PDF export; reuses AI Core/HITL (§20); community updates viaattestation_community_updates. - Service Directory (§98/ADR-106): reuses
contentswithcontent_type = 'service_listing'service_listing_metaextension; geo-indexed; reuses Ratings & Reviews (§29) and Organizations (§07);service.create/service.verify/service.claimRBAC.
- Language Test Hub (§99/ADR-107):
language_tests+_requirements+_resources+language_score_storiestables; reuses Scholarship Finder (§73) and Community Story Wall (§79). - Tax Calculator (§100/ADR-108):
tax_treaty_pairs+tax_obligation_guidestables; HITL mandatory for tax content (tax_content.review— qualified reviewer only); reuses AI Core (§20) and Service Directory (§98). - Diaspora Community Locator (§101/ADR-109):
community_organisationstable; reuses Organization Profiles (§07) and Space system (§05); OpenStreetMap/Leaflet maps;community_locator.submit/review/claim/manageRBAC. - Mentorship Matching (§102/ADR-110): adds mentor opt-in columns to
user_profiles+mentorship_connectionstable;active_mentee_countmaintained by PostgreSQL trigger (trg_mentee_count— not computed at query time); hybrid match scoring: 60% keyword overlap- 40% pgvector cosine similarity;
mentor:generate_embeddingandmentor:update_meilisearchtasks (low queue); reuses Generic Comparison System (§30) for/compare/mentors; DM auto-open on connection accept (§48);mentorship.max_capacitysetting;mentorship.become_mentor(professional/agent/moderator/admin),mentorship.request(member+),mentorship.respond,mentorship.manageRBAC nodes.
- 40% pgvector cosine similarity;
- AI Personas (§68/ADR-068): persona provisioning is transactional (account + byline +
- Fix: implement missing logic, complete unwired handlers, add the missing migration/sqlc query
(edit
db/queries/, runmake sqlc-gen— never hand-editinternal/db/), add RBAC node + cache invalidation, add Valkey key to catalog, register Asynq task in catalog, enforcesystem_settings, return standard{ "data": ... }/{ "error": { "code", "message" } }. - Verify the route returns non-404/non-500 under correct auth and matches the section's contract. For v2 routes, also verify the v2 Mandatory Pattern above for that feature holds.
Options 3–9 — Whole Surface Audit + Fix
Trigger
- User picks Option 3–9 from the menu, OR
- User invokes
/japa-bugs-hunters "audit <surface>"or/japa-bugs-hunters "fix <surface>"with a surface keyword (backend,main,control,admin,docs,learn,tools) — see routing rule 4.
Map the surface to its bug sections, then audit file-by-file and fix:
- Option 3 — Backend (whole): all
[BE]/[BOTH]sections above; prioritize §21 (stub/missing routes — every one of the ~819 catalogued routes must be reachable & non-stub), §22 (18 Golden Rules), §26 (RBAC node reconciliation — 297 nodes total: 249 v1 + 48 v2), §9 (tenant scoping), §10 (Asynq catalog — 95 tasks). Apply the v2 catalog completeness gate: all four catalogs (routes, settings, Valkey, Asynq) must reflect v2 code before a v2 phase is marked complete; verify the 20 new v2 tables (§§60–78) and the ~23 new v2 tables (§§79–102 — story_meta, wiki_pages, wiki_revisions, scam_reports, scam_alert_subscriptions, planning_groups ×4, visa_timelines ×2 + materialized view, digest_editions, mutual_aid_posts, calendar_entries ×3, achievement_meta, visa_routes, appointment_alerts ×2, arrival_checklist_guides ×2, credential_professions ×3, cv_standards ×2, housing_guides, attestation_pathways ×2, service_listing_meta, language_tests ×4, tax_treaty_pairs ×2, community_organisations, mentorship_connections); verify task idempotency per v2 task; verify the high-stakes gate cannot be bypassed via config; verify synthetic activity (is_synthetic) is excluded from real-metric materialized views; verify the geo-aware tool pattern (?dest=filter, no hardcoded nationality) on all §§79–101 endpoints; verify ADR-088 AI generation columns on all admin-managed content tables; verify feature-flag middleware returns 404 (not 403) when disabled (ADR-042); verify mentorshiptrg_mentee_counttrigger exists andactive_mentee_countis not computed at query time. Use thejapa-backend-auditorskill's route/node/catalog reconciliation approach (incl. its Section K — V2 Audit Checklist) as a sub-routine. - Option 4 — Main (apps/main): §1, §2, §3, §6, §7, §16 (SSR/hydration), §17 (where shared), §18,
§21, §27 (Rule 16), §36 (learning routes). Enforce ADR-058 shell, LayerChart 2.0.1, Bits UI,
$t()i18n, no hardcoded data, JSON-LD/SEO. For v2 main phases (33–38: identity tools UI, community+social, growth+import, community features), also check §§70–73 tool UIs, §74 remittance UI, §§79–89 community feature UIs (story wall, wiki, scam alert, planning groups, visa timeline, digest, mutual aid, calendar, japa stage, AMA, achievement feed), §98 service directory UI, and §102 mentorship UI. Verify geo-aware destination selector is first input on all §§79–101 pages. Usejc-main-auditpatterns. - Option 5 — Control (apps/control): §2, §3, §6, §7, §16 (SPA), §17 (SPA specifics: auth guard
loop, polling leak, Bits UI key handling, LayerChart
xPaddingnotxNice), §21, §27. For v2 control phases, verify settings forms for the 62 new v2system_settingskeys (incl. 14 tool-domain keys for §§79–101 subdomain/custom_domain settings andmentorship.max_capacity). Usejc-control-auditpatterns. - Option 6 — Admin (apps/admin): §2, §3, §6, §7, §16 (SPA), §17, §21, §23 (forms), §25 (custom
fields), §26 (RBAC wiring vs sidebar nav map), §27. For v2 admin phases (20–27: persona management
- studio, newsletter + jobs, gamification + analytics + commerce, community features + functional
tools + mentorship), also check §§68/75/62/63/64/66 admin surfaces and §§79–102 admin surfaces
(story verification, wiki revision approval, scam alert moderation, planning group management,
visa timeline admin, digest generation/publish, mutual aid moderation, calendar review, visa
route management, embassy polling, arrival checklist approval, credential checker management, CV
formatter standards, housing guide management, attestation approval, service verification/claim
review, language test requirements management, tax guide/treaty management, community locator
review, mentorship connection management). Verify ADR-088 HITL review gate on all AI-generated
content. Use
jc-admin-auditpatterns.
- studio, newsletter + jobs, gamification + analytics + commerce, community features + functional
tools + mentorship), also check §§68/75/62/63/64/66 admin surfaces and §§79–102 admin surfaces
(story verification, wiki revision approval, scam alert moderation, planning group management,
visa timeline admin, digest generation/publish, mutual aid moderation, calendar review, visa
route management, embassy polling, arrival checklist approval, credential checker management, CV
formatter standards, housing guide management, attestation approval, service verification/claim
review, language test requirements management, tax guide/treaty management, community locator
review, mentorship connection management). Verify ADR-088 HITL review gate on all AI-generated
content. Use
- Option 7 — Docs (apps/docs): §1, §2, §3, §6, §7, §16 (SSR, ADR-060 nav-tree/TOC), §18, §21, §27. Verify OpenAPI spec currency against the ~819-route catalog (§47).
- Option 8 — Learn (apps/academy): §1, §2, §3, §6, §7, §16 (SSR, ADR-060 lesson-player exception), §18, §21, §27, §36 (learning routes). No new v2 learn pages per ADR-060.
- Option 9 — Tools pages (apps/main
/tools/*): §1, §2, §3, §6, §7, §16 (SSR), §18, §21, §27, §78 (host-detection hub/single-tool shell, ADR-086). Verifyhooks.server.tshost detection reads per-toolsystem_settingsdomain keys (14 tool-domain settings for §§79–101 functional tools); verify hub shell renders all tools and single-tool shell renders tool-specific branding with NO cross-tool nav; verify CORSallowed_originscovers active domains; verifyjapaconnect_coreimport where used; verify geo-aware tool pattern on all §§90–97, §§99–101 tool pages (destination selector first,?dest=filter, no hardcoded nationality). Usejc-tools-auditpatterns.
For each surface, produce the structured report (see below) and apply fixes until clean. Re-run the
dev server / svelte-check / go build ./... / gosec as appropriate to verify.
Option 10 — Feature Audit (from ./internal)
This is a read-only audit + findings report workflow. Unlike Options 1–9, Option 10 does not
auto-fix bugs — it produces a categorized findings file in ./.jeos/audit/ for the user to triage.
The user supplies [feature_name] = any folder under ./internal (e.g. forum, like, bookmark,
ai, affiliate, persona, rag, remittance, studio, newsletter, gamification,
story_wall, wiki, scam_alert, planning_group, visa_timeline, digest, mutual_aid,
calendar, mentorship, visa_routes, embassy, arrival_checklist, credential_checker,
cv_formatter, housing_guide, attestation_guide, service_directory, language_test_hub,
tax_calculator, community_locator).
Trigger
- User picks Option 10 from the menu, OR
- User invokes
/japa-bugs-hunters "audit [feature_name]"(case-insensitive, quotes optional).
Run the following prompt against the supplied [feature_name], then save the output to
./.jeos/audit/<feature_name>-audit.md (create the .jeos/audit/ folder if it does not exist):
There are multiple irregularities in the [feature_name] features, thoroughly review and audit the [feature_name] feature for bugs, business logics, backend communication, UI Logics, UX Logics, and all its intended functionalities according to JEOS Specs. Save your findings to a file in
./.jeos/auditfolder.a. Map backend [feature_name] feature (handlers, services, stores, migrations, RBAC, Valkey, Asynq, GDPR). b. Map frontend [feature_name] feature across all 6 SvelteKit apps + Flutter mobile (components, pages, API calls, UI/UX, i18n). c. Map JEOS spec for [feature_name] feature (sections, routes catalog, permissions, Valkey, Asynq, settings, ADRs). d. Cross-check implementation against JEOS spec; identify conformance gaps. e. Categorize bugs by class (business logic, backend comms, UI/UX, RBAC, security, performance, GDPR).
Execution Steps
- Validate the feature name. Confirm
./internal/<feature_name>exists. If not, list./internal/*subdirectories and ask the user to pick a valid one. - Read the Guide (
.jeos/.ai/skills/japa-bugs-hunters.md) and the relevant.jeos/sections/*files for the feature (search by feature name — v1 §§01–59 and v2 §§60–102). Also readconventions/api-routes-catalog.md,permission-key-naming.md,valkey-keys-catalog.md,asynq-tasks.md,system-settings-catalog.md. For §§79–101 features, also read.jeos/skills/geo-aware-tool-pattern.md. - (a) Map backend — list every handler, service, store, sqlc query, migration, RBAC node,
Valkey key, Asynq task, and GDPR erasure entry that belongs to the feature. Use
grep/globover./internal/<feature_name>,./internal/db/queries/,./db/migrations/,./internal/rbac/,./internal/valkey/,./internal/asynq/,./internal/gdpr/. For v2 features, also check the v2 Mandatory Patterns (Option 2 step 4) andis_synthetic/high-stakes-gate conformance. For §§79–102 features, also check the geo-aware tool pattern conformance (?dest=filter, no hardcoded nationality, destination_country_id in schema) and ADR-088 AI generation column conformance. - (b) Map frontend — for each of the 6 SvelteKit apps (
apps/main,apps/admin,apps/control,apps/academy,apps/docs) plus the Flutterapps/mobilewhere relevant, list components/screens, pages/routes, API calls (/api/v1/<feature>/*), UI/UX flows, and i18n keys referencing the feature. Forapps/mobile/, map:- Feature module under
lib/features/<feature_name>/ - Screens (
lib/features/<feature_name>/screens/) - Providers / notifiers (
lib/features/<feature_name>/providers/) - API client calls through
japaconnect_core - Shared widgets used from
japaconnect_core/lib/widgets/ - Rule 16 compliance (no hardcoded data)
- Feature module under
- (c) Map JEOS spec — list every section (v1 §§01–59 or v2 §§60–102), route catalog entry, permission key, Valkey key, Asynq task, system setting, feature flag, and ADR that governs the feature. For §§79–101 features, also map the geo-aware tool pattern requirements.
- (d) Cross-check — for each spec item, mark ✅ (implemented & conformant) / ⚠️ (implemented but non-conformant) / ❌ (missing). Record the conformance gap with file:line citations.
- (e) Categorize bugs by class:
business-logic,backend-comms,ui-ux,rbac,security,performance,gdpr. For each bug include: id, class, severity (critical/high/medium/low), title, file:line, description, spec reference, suggested fix. - Save findings to
./.jeos/audit/<feature_name>-audit.mdusing the template below. - Do not apply fixes unless the user explicitly asks. Option 10 is audit-only; the user can later trigger Options 1–9 or Option 11 to fix specific bugs surfaced here.
Findings File Template — ./.jeos/audit/<feature_name>-audit.md
# Feature Audit — <feature_name>
- Date: <ISO date>
- Auditor: japa-bugs-hunters (Option 10)
- Feature path: ./internal/<feature_name>
## 1. Backend Map
- Handlers: <list with file:line>
- Services: <list>
- Stores / sqlc queries: <list>
- Migrations: <list>
- RBAC nodes: <list>
- Valkey keys: <list>
- Asynq tasks: <list>
- GDPR erasure coverage: <tables covered / missing>
## 2. Frontend Map (all 6 apps + mobile)
### apps/main
- Components: <list> · Pages: <list> · API calls: <list> · i18n keys: <list>
### apps/admin
- ...
### apps/control
- ...
### apps/academy
- ...
### apps/docs
- ...
### apps/mobile (Flutter, if relevant)
- Feature module: `lib/features/<feature_name>/`
- Screens: <list> · Providers: <list> · Services: <list>
- `japaconnect_core` API calls: <list>
- Shared widgets used: <list>
- Rule 16 (hardcoded data): ✅/❌
- `flutter analyze` status: ✅/❌
## 3. JEOS Spec Map
- Sections: <list>
- Routes catalog entries: <list>
- Permission keys: <list>
- Valkey keys: <list>
- Asynq tasks: <list>
- System settings: <list>
- Feature flags: <list>
- ADRs: <list>
- Geo-aware tool pattern requirements (if §§79–101): <list>
## 4. Conformance Cross-Check
| Spec item | Status | Implementation | Gap |
| --- | --- | --- | --- |
| ... | ✅/⚠️/❌ | <file:line or "missing"> | <description> |
## 5. Bugs by Class
### business-logic
- BUG-001 [severity] — <title> — <file:line> — <description> — spec ref — suggested fix
### backend-comms
- ...
### ui-ux
- ...
### rbac
- ...
### security
- ...
### performance
- ...
### gdpr
- ...
## 6. Summary
- Total bugs: <n> (critical <n>, high <n>, medium <n>, low <n>)
- Conformance: <n> ✅ / <n> ⚠️ / <n> ❌
- Top priorities: <3-5 bullet list>
Option 11 — Fix Feature Audit Findings
This workflow consumes the audit file produced by Option 10 (./.jeos/audit/<feature_name>-audit.md)
and applies fixes to every open bug entry. It reuses the standard japa-bugs-hunters fix rules
(Options 1–9 + Cross-Cutting Fix Rules) but is driven by the audit's bug list instead of a live
page/route scan.
Trigger
- User picks Option 11 from the menu, OR
- User invokes
/japa-bugs-hunters "fix [feature_name]"(case-insensitive, quotes optional).
Execution Steps
Resolve the feature name.
- From the shortcut trigger: parse
[feature_name]out of the user's input. - From the menu: ask the user to input the feature name.
- From the shortcut trigger: parse
Locate the audit file at
./.jeos/audit/<feature_name>-audit.md.- If it does not exist: list every file in
./.jeos/audit/and ask the user to pick one, or offer to run Option 10 first to produce the audit. Do not proceed without an audit file.
- If it does not exist: list every file in
Read the audit file in full and parse every bug entry under
## 5. Bugs by Class. Each bug line follows the template:- BUG-### [severity] — <title> — <file:line> — <description> — spec ref — suggested fix- Skip any bug line already prefixed with
✅ ALREADY IMPLEMENTED(see marking rule below) — those are previously fixed bugs and must never be re-fixed.
- Skip any bug line already prefixed with
Read the Guide (
.jeos/.ai/skills/japa-bugs-hunters.md) in full before applying any fix — the section numbers cited in the audit'sspec reffield map to Guide sections.Fix bugs in priority order:
critical→high→medium→low. Within a severity tier, fix in bug-id order (BUG-001,BUG-002, ...). Use atodo_writelist to track every open bug.For each bug, apply the matching fix workflow from Options 1–9 based on its class:
business-logic,backend-comms,rbac,security,performance,gdpr→ use the Option 2 (Backend API / Route) workflow against the bug'sfile:line. For v2-feature bugs, also apply the v2 Mandatory Patterns (Option 2 step 4). For §§79–102 feature bugs, also apply the v2 community/tool patterns (Cross-Cutting Fix Rules, v2 community/tool patterns section).ui-ux→ use the Option 1 (Frontend URL / Page) workflow against the bug'sfile:line(resolve the app from the path:apps/main→main,apps/admin→admin,apps/control→control,apps/academy→learn,apps/docs→docs,apps/mobile→mobile). For SvelteKit apps, launch Playwright to verify the fix when the bug is visual/interactive. Forapps/mobile/, verify withflutter analyze+flutter test; run on an emulator/simulator if the visual fix must be validated. Usejc-mobile-debug/jc-mobile-refactoras the implementation guide.- All fixes must obey the Cross-Cutting Fix Rules (Golden Rules, RBAC, multi-tenancy, custom fields, v2 patterns) and the standard Report Format.
Verify each fix before marking it done:
- Backend:
go build ./...(andgo test ./internal/<feature_name>/...if tests exist), plusgosecfor security-class bugs. - Frontend:
svelte-checkfor the relevant SvelteKit app, plus a Playwright pass forui-uxbugs. Forapps/mobileuseflutter analyzeandflutter test. - A fix is "successful" only when the relevant verifier passes and the original bug symptom is gone.
- Backend:
Mark the bug line in the audit file immediately after a successful fix. Use the
edittool to prefix the bug line with✅ ALREADY IMPLEMENTED —and append— fixed <ISO date>at the end. The marked line must look exactly like:- ✅ ALREADY IMPLEMENTED — BUG-### [severity] — <title> — <file:line> — <description> — spec ref — suggested fix — fixed <ISO date>Marking rules (critical):
- Only mark a bug after its fix is verified — never speculatively.
- Never delete or rewrite the original bug line; only prepend
✅ ALREADY IMPLEMENTED —and append— fixed <ISO date>. The original text must remain intact for traceability. - If a fix fails verification, leave the bug line unmarked and record the failure reason in the
final report. Do not mark it
ALREADY IMPLEMENTED. - Never re-fix a line already prefixed with
✅ ALREADY IMPLEMENTED. If the user re-runs Option 11, skip all marked lines and only process unmarked bug entries.
Update the audit file's
## 6. Summarysection at the end of the run with the new counts:Fixed this run: <n>Already implemented (prior runs): <n>Remaining open: <n>Keep the original totals line intact for history; append the new lines below it.
Produce the standard Bug Hunt Report (see Report Format) at the end of the run, scoped to the feature and listing every file changed, every backend addition (routes, migrations, RBAC nodes, Valkey keys, Asynq tasks), and the verification results.
Re-run Safety
Because every fixed bug is marked ✅ ALREADY IMPLEMENTED in place, Option 11 is idempotent:
re-running it (or re-triggering /japa-bugs-hunters "fix [feature_name]") will only process bugs
that are still open. This prevents duplicate work and avoids confusion when the user runs the fix
workflow multiple times or resumes after an interruption.
Cross-Cutting Fix Rules (must hold for every fix)
- Golden Rules (
AGENTS.md): section is source of truth (R1); never hand-editinternal/db/(R2); config fromJC_*/system_settings, never hardcoded (R3); Valkey keysjc:-prefixed + cataloged (R4); standard error envelope (R5); invalidatejc:perm:{user_id}on group/role/mod/ban changes (R6); Asynq task name in catalog (R7); fan-out fire-and-forget (R8);SET NX EXidempotency on financial endpoints (R9); impersonation writesaudit_logs(R10); soft-delete only for user content (R11); computecontent_hashbefore everycontentssave (R12); circular-FK migration ordering (R13); read all referenced sections (R14); all ~819 routes return non-404 under auth (R15); frontend API-only, no hardcoded/mock data (R16); no AI authorship attribution (R17); always usebunfor JS/TS tooling — nevernpm/npx/pnpm/yarn(R18). - RBAC: every
hasPermission()node must exist in thepermissionsseed using_own/_anyscoping;super_adminholds all nodes (297 nodes total: 249 v1 + 48 v2);membersholds exactly the 45 member-level nodes. - Multi-tenancy: every query, Valkey key, and Meilisearch filter carries
tenant_id. - Custom fields: correct
field_type,optionsjsonb shape, RBAC-per-field scoping, validentity_classassignment. - v2 patterns (JEOS v1.16.0–v1.23.1): synthetic activity is always flagged internally via
is_bot/is_syntheticand excluded from real-metric materialized views (P10); the high-stakes HITL gate (immigration/financial/grants/health) is unconditional and cannot be bypassed via config; persona backing accounts are permanentlyis_bot; RAG embeddings use upsert on publish/edit; content studio jobs are idempotent onstudio_job_id; remittanceapi_configis encrypted and rate history is append-only; newsletter unsubscribe tokens are single-use; one backend serves all client surfaces — no per-surface backend duplication (P9); reuse existing infrastructure over building new (P11). - v2 community/tool patterns (JEOS v1.22.0–v1.23.1, §§79–102): the geo-aware tool pattern
governs all §§79–101 features — destination country is the primary data axis, no hardcoded
nationality,
?dest=filter on all list/lookup endpoints,destination_country_idin schema, destination selector is first UI input; ADR-088 universal AI content generation applies to all admin-managed content tables (ai_generated,ai_model,hitl_reviewed_by,ai_generated_atcolumns, AI via existing §20 Gateway, HITL review mandatory before publish); feature-flag middleware returns 404 (not 403) when disabled (ADR-042); RBAC seed migration uses000NNN_seed_{feature_domain}_rbac_nodes.sqlnaming; admin list endpoints must filter + sort + paginate (no infinite scroll);is_japabot_indexedcomputed column on RAG-retrievable content; mentorshipactive_mentee_countmaintained by PostgreSQL trigger (not query-time computation); mentorship match scoring is 60% keyword overlap + 40% pgvector cosine similarity; community features reusingcontentstable must use the correctcontent_typediscriminator (story,achievement,service_listing).
Report Format
End every run with:
## Bug Hunt Report — <target>
- Mode: <option 1-11> · App/Surface: <...> · Route(s): <...>
- Bugs found: <n> (Frontend: <n> · Backend: <n>)
- Fixed: <n> · Remaining: <n> (with reason if any)
- Backend changes: routes added <list>, migrations <list>, RBAC nodes <list>, Valkey keys <list>,
Asynq tasks <list>
- Files changed: <list>
- Verification: <Playwright pass / go build / svelte-check / flutter analyze / flutter test / gosec result>
- Checklist A (JEOS Conformance) and B (Feature-completeness) from the Guide: ✅/❌ per item
- v2 conformance (if a v2 feature): synthetic-activity flagging ✅/❌, high-stakes gate ✅/❌,
catalog completeness gate ✅/❌
- v2 community/tool conformance (if §§79–102 feature): geo-aware tool pattern ✅/❌, ADR-088 AI
generation columns ✅/❌, HITL review gate ✅/❌, feature-flag 404 (not 403) ✅/❌
Reference Files
.jeos/.ai/skills/japa-bugs-hunters.md— the full bug taxonomy (read first, every run)..jeos/JEOS.md— index of all 102 sections, 110 ADRs, 10 conventions, 8 roadmaps..jeos/AGENTS.md— the 18 Golden Rules..jeos/conventions/api-routes-catalog.md—819 routes (475 v1 + ~344 v2; existence/contract check)..jeos/conventions/permission-key-naming.md(297 RBAC nodes: 249 v1 + 48 v2),system-settings-catalog.md(187 keys: 125 v1 + 62 v2),valkey-keys-catalog.md(69 patterns: 59 v1 + 10 v2),asynq-tasks.md(95 tasks: 75 v1 + 20 v2),feature-flag-naming.md(~24 flags),api-response-format.md,database-migration-naming.md,svelte-component-patterns.md..jeos/sections/03-rbac.md,sections/06-custom-field-builder-form-builder.md(v1); v2 sectionssections/60-referral-system.mdthroughsections/78-tools-web-surface.md(§§60–78, ADRs 061–086); v2 community featuressections/79-community-story-wall.mdthroughsections/89-achievement-feed.md(§§79–89, ADRs 087–097); v2 functional toolssections/90-visa-route-comparison.mdthroughsections/97-attestation-guide.md(§§90–97, ADRs 098–105);sections/98-service-directory.md(§98, ADR-106);sections/99-language-test-hub.mdthroughsections/101-diaspora-community-locator.md(§§99–101, ADRs 107–109);sections/102-mentorship-matching.md(§102, ADR-110)..jeos/skills/geo-aware-tool-pattern.md— the geo-aware tool pattern governing all §§79–101 features..jeos/adr/ADR-058-main-app-shell.md,ADR-060-learn-docs-shell-profile-hub.md,ADR-068-ai-persona-system.md,ADR-069-japabot-rag-knowledge-layer.md,ADR-076-ai-content-studio.md,ADR-077-participation-orchestration-engine.md,ADR-086-multi-surface-client-architecture.md,ADR-088-destination-wiki.md(universal AI content generation pattern),ADR-110-mentorship-matching.md(trigger-maintained counts, 60/40 scoring)..jeos/roadmaps/ROADMAP-V2.md(v2 planning index),ROADMAP-TOOLS.md(tools surface)..jeos/.ai/skills/backend/and.jeos/.ai/skills/frontend/— the jc-* develop/audit/debug/refactor skills per surface (use as sub-routines per the surface options above). For mobile, loadjc-mobile-develop,jc-mobile-debug,jc-mobile-audit, andjc-mobile-refactorfrom.jeos/.ai/skills/frontend/07-mobile/.