Name: RadarScholar
Author: yzffm

Imported from yzffm/RadarScholar (AGENTS.md). Install upstream with npx skills add yzffm/RadarScholar. Copyright stays with the author.

AGENTS.md — RadarScholar AI Agent Instructions

This file is the engineering constitution for AI Agents working on RadarScholar. Technical Docs.md is the human-facing technical source of truth. The human project owner has final authority over material product and architecture decisions.

For complete agent instructions, see:

.agents/rules/agents.md — Core agent rules (§1–§23)
.agents/rules/agents2.md — Extended rules (§24–§30)

Quick Reference

Mission

Build RadarScholar — a Scholarship Intelligence Platform — correctly, incrementally, and transparently.

Current Stack

Layer	Technologies
Frontend	Flutter Web/Dart, Material 3, Riverpod, GoRouter, Dio, Freezed, json_serializable
Backend	Python, FastAPI, Pydantic, SQLAlchemy 2.x, Alembic, Uvicorn
Database	PostgreSQL, Supabase, Supabase Auth
AI	Gemini (primary), Groq (fallback), Ollama (optional/local)
Crawler	httpx, BeautifulSoup4, lxml, Playwright, PyMuPDF, GitHub Actions
Testing	pytest, flutter_test, integration_test, Ruff, dart format, flutter analyze

Milestones

M0  Foundation          ← current
M1  Design System & App Shell
M2  Authentication & Profile
M3  Scholarship Data Foundation
M4  Scholarship Discovery
M5  Matching
M6  Saved & Application Tracking
M7  Curated Crawler
M8  AI Intelligence
M9  AI Application Assistant
M10 Source Monitoring/Admin
M11 Hardening
M12 Deployment/Release

Key Rules

Never fabricate scholarship facts, user achievements, or data
Never store plaintext passwords or commit secrets
Never bypass anti-bot/access controls in crawling
AI assists but does not decide objective eligibility
Milestone discipline — don't implement future features
Human approval required for material architecture changes

CPMK Requirements

API Integration (Flutter → FastAPI)
Responsive UI (desktop/tablet/mobile)
GitHub repository
MVC architecture
Mobile compilation (Android)
ListView.builder for dynamic collections

{ "ocm": "1", "id": "yzffm-radarscholar-radarscholar", "kind": "skill", "name": "RadarScholar", "description": "For complete agent instructions, see: - [`.agents/rules/agents.md`](.agents/rules/agents.md) — Core agent rules (§1–§23) - [`.agents/rules/agents2.md`](.agents/rules/agents2.md) — Extended rules (§24–§30)", "publisher": "yzffm", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "For complete agent instructions, see: - [`.agents/rules/agents.md`](.agents/rules/agents.md) — Core agent rules (§1–§23) - [`.agents/rules/agents2.md`](.agents/rules/agents2.md) — Extended rules (§24–§30)" ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/yzffm/RadarScholar", "path": "AGENTS.md", "ref": "2ac51ceee1e3fc9fd09d7723fa322174d7e02933", "url": "https://github.com/yzffm/RadarScholar/blob/2ac51ceee1e3fc9fd09d7723fa322174d7e02933/AGENTS.md", "key": "yzffm/RadarScholar/AGENTS.md" } }, "instructions": "# AGENTS.md — RadarScholar AI Agent Instructions\n\n> This file is the engineering constitution for AI Agents working on RadarScholar.\n> `Technical Docs.md` is the human-facing technical source of truth.\n> The human project owner has final authority over material product and architecture decisions.\n\nFor complete agent instructions, see:\n- [`.agents/rules/agents.md`](.agents/rules/agents.md) — Core agent rules (§1–§23)\n- [`.agents/rules/agents2.md`](.agents/rules/agents2.md) — Extended rules (§24–§30)\n\n## Quick Reference\n\n### Mission\nBuild RadarScholar — a Scholarship Intelligence Platform — corr", "cost": { "context_tokens": 531 } }

RadarScholar

About

AGENTS.md — RadarScholar AI Agent Instructions

Quick Reference

Mission

Current Stack

Milestones

Key Rules

CPMK Requirements

Use it

Manifest

Reviews