project-overview

Project-specific guidance describing the system’s architecture, folder layout, technologies, and feature areas. A monorepo is one repository containing multiple parts of a project, such as its client and server.

In plain words
What is it for?
Use it when working on the PCIC management system, especially its React client, Express server, MongoDB data, and listed feature modules.
Why use it?
It gives the coding agent the background needed to make changes that fit the existing project.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/ayimmam/pcic/project-overview
Clone the repo
git clone --depth 1 https://github.com/ayimmam/PCIC

Made for: Cursor.

Per session 665 This file is loaded in full into every session.
When invoked 665 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00665 $0.00665
Opus 5 $0.00332 $0.00332
Sonnet 5 $0.00133 $0.00133
Haiku 4.5 $0.00067 $0.00067

Measured 2d ago against content hash d9650a9e664c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

project-overview scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- API calls go through `client/src/api/axios.js` (auto-attaches JWT)
.cursor/rules/project-overview.mdc · 55 lines

How it starts

The opening of the file, as written. The whole thing — 55 lines — stays where its author put it; the contents beside it link to each section on GitHub.

PCIC Internal Management System

Web platform for the Peak Craft Informatics Community (800+ students across IS, CS, IT at Hawassa University). Digitizes membership tracking, event attendance, leadership decisions, and disciplinary workflows.

Monorepo Layout

client/   — React 18 (JSX, NOT TypeScript) + Vite + Shadcn UI + Tailwind CSS
server/   — Node.js + Express.js + Mongoose (ES modules)

Tech Stack (do NOT deviate)

  • Frontend: React 18, Vite, JSX (no .tsx/.ts), Shadcn UI, Tailwind CSS, React Router v6, TanStack React Query v5, react-hook-form + zod, Sonner toasts, Lucide icons
  • Backend: Express.js, Mongoose ODM, JWT auth (jsonwebtoken + bcryptjs), Multer uploads, Nodemailer emails
  • Database: MongoDB
  • Path alias: @/ maps to client/src/ via jsconfig.json

Feature Modules (Phase 2 MVP)

ID Feature Frontend Page Backend Route
F-001 Event Attendance Tracker /events /api/events
F-012 Centralized Decision Repo /reports /api/decisions
F-006 Disciplinary Strike System /admin (strikes tab) /api/strikes
F-004 Accelerated Entry Workflow /career /api/candidates
Member Management /members /api/members

User Roles (enforced by roleGuard.js backend + RoleGate.jsx frontend)

  • president, vice_president, secretary — executive / org-wide duties per route
  • pm (product manager) — manage members, change statuses, create decisions
  • mc (membership coordinator) — change member status, track attendance
  • pr (public relations), event_organizer (event team) — per route
  • domain_leader — create events for their PCIC domain (see domains below)
  • member — view events, check in, view own profile

PCIC domains (User.domain / Event.domain)

Only: Code Crafters, Turing Tribe, Cyber Crew, Pixel Peeps (not legacy labels like “Technical” or “General”).

Key Conventions

  • All files use ES module syntax (import/export, not require)
  • Frontend components are functional components with hooks
  • API calls go through client/src/api/axios.js (auto-attaches JWT)
  • Data fetching uses React Query hooks in client/src/hooks/
  • Backend follows routes → controllers → models pattern
  • All API routes are prefixed with /api/

Read the full file on GitHub · 55 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 55 lines · 665 tokens per session scan A d9650a9e664c

Subscribe to this mod's changes

project-overview is a cursor rule published in the GitHub repository ayimmam/PCIC (2 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 665 tokens to every session, about $0.0033 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.