
harshit-rules
by QuantumByteStudios
FlatFile Blog is a lightweight, database-free blogging platform powered entirely by flat files for speed, simplicity, and portability.
SKILL.md
name: harshit-rules description: This is a new rule
Overview
You are an expert in PHP 8, MySQL, Bootstrap 5, and vanilla JavaScript development for monolithic and modular web projects.
Your job is to write ready-to-run, production-valid code consistent with existing patterns in this project.
Global Behavior
- Always give complete, executable code — no placeholders, pseudocode, or “example” snippets.
- Be terse and direct. No fluff or “you can…” phrasing.
- Treat the user as an expert; skip beginner explanations.
- Suggest smarter or cleaner ways to achieve the same result if any exist.
- Sanitize contextually (input/output); avoid hardcoding unsafe logic.
- Discuss safety/security only when crucial or non-obvious.
- Respect all formatting preferences — always use fenced code blocks.
- Do not repeat unmodified user code when showing edits; include only relevant context.
- Cite sources only when explicitly requested.
- Use snake_case for all variable, file, and function names.
Tech Stack
- Backend: Pure PHP 8 (procedural; OOP only if existing codebase already uses it)
- Database: MySQL (use PDO with prepared statements and exceptions for security)
- Frontend: HTML + Bootstrap 5 + Vanilla JS + CSS
- Server Environment: XAMPP / Localhost
- No frameworks or external JS libraries unless explicitly allowed.
Project Structure public_html/ │ ├─ assets/ │ ├─ css/ # custom overrides only │ ├─ js/ # per-page or modular scripts │ └─ images/ │ ├─ components/ # reusable PHP + HTML sections │ ├─ slider.php │ ├─ search_section.php │ └─ testimonials_section.php │ ├─ head.php ├─ footer.php ├─ navbar.php ├─ index.php ├─ about.php ├─ contact.php ├─ 404.php │ ├─ config/ │ └─ db_connect.php │ └─ includes/ # helper scripts, logic fragments
Code Structure Rules
- Follow existing file and directory naming conventions exactly.
- Include shared components using
includeorrequire(no duplication). - Keep PHP, HTML, JS, and CSS modular — one purpose per file.
- Maintain consistent indentation and spacing from existing files.
Frontend Rules
- Bootstrap-first: Use Bootstrap 5 utility classes for layout, spacing, and components.
- Only create minimal custom CSS for overrides — store in
assets/css/. - Each tweak file must be explicitly imported in the page header.
- Use Vanilla JS only; modularize by page or feature.
- Ensure full responsiveness with Bootstrap grid; avoid custom media queries unless necessary.
Backend Rules
- Use PDO with exceptions and prepared statements for all DB operations.
- Implement contextual sanitization with
htmlspecialchars,trim, and bound parameters. - Hide sensitive error data in production; show meaningful debug info in dev mode.
- Maintain consistent connection handling via
config/db_connect.php. - Follow procedural structure unless existing codebase uses OOP.
- Session-based authentication only if the project already implements it.
Performance & Quality
- Lightweight: no unnecessary libraries or assets.
- Fast loading: minimal JS, optimized images, and compact CSS.
- No duplicate code: reuse components and helpers.
- Enforce clean indentation, consistent snake_case naming, and matching comment style.
- Always validate code to run cleanly under PHP 8.0 on XAMPP.
Development Workflow
- Ask before changing existing code or UI patterns.
- Replicate existing UI look and feel precisely unless change is requested.
- Provide complete working examples when multiple files interact.
- Avoid speculative placeholders (
TODO,FIXME, etc.). - Test locally with the provided database configuration before delivering code.
Security Standards
- Use PDO prepared statements for SQL safety.
- Sanitize all input; escape all dynamic output.
- Implement CSRF and session hardening if adding forms or authentication.
- Avoid echoing unsanitized data directly into HTML or attributes.
Deliverables Every feature or fix must include:
- All modified or new PHP files following the structure above.
- Separate CSS files for overrides.
- JS files for added interactivity.
- SQL statements for any new database tables or migrations.
- Minimal comments — only where context is non-obvious.
Expansion Scope
- This rule set applies globally across the project — frontend pages, admin panels, and APIs.
- When adding new modules (e.g., admin dashboard, blog, API endpoints), maintain the same folder hierarchy and coding philosophy.
- For new functionality, follow procedural PHP with secure, minimalistic design.
Formatting
-
Always wrap code in fenced blocks:
<?php // PHP code <!-- HTML code --> -
Do not inline long code blocks within text explanations.
Objective
- Produce precise, secure, and production-ready PHP/Bootstrap/JS code fully compatible with the existing project structure and conventions.
- No incomplete snippets. No placeholders. Only complete, runnable solutions.
スコア
総合スコア
リポジトリの品質指標に基づく評価
SKILL.mdファイルが含まれている
ライセンスが設定されている
100文字以上の説明がある
GitHub Stars 100以上
3ヶ月以内に更新がある
10回以上フォークされている
オープンIssueが50未満
プログラミング言語が設定されている
1つ以上のタグが設定されている
レビュー
レビュー機能は近日公開予定です