From e86dfb8f63a735fafa29045968036014f80f556a Mon Sep 17 00:00:00 2001 From: delatorrecj Date: Wed, 2 Sep 2026 23:07:59 +0800 Subject: [PATCH 1/2] docs: AI handover INDEX STATE FLAGS Contributors Add FMD-philosophy control plane for humans and agents. Credit real git contributors from the Nexus roster. Record product gaps in FLAGS only; no application code changes. Co-authored-by: Cursor --- AGENTS.md | 24 ++++++++++++++++++++++++ FLAGS.md | 11 +++++++++++ README.md | 18 ++++++++++++++++++ docs/index.md | 23 +++++++++++++++++++++++ docs/state.md | 27 +++++++++++++++++++++++++++ 5 files changed, 103 insertions(+) create mode 100644 AGENTS.md create mode 100644 FLAGS.md create mode 100644 docs/index.md create mode 100644 docs/state.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..9eadaa3 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,24 @@ +# AGENTS.md - Code Rush + +Guidance for AI agents and humans working in this repository. + +## Read order (every session) + +1. [docs/state.md](docs/state.md) - operating position (Archive) +2. [docs/index.md](docs/index.md) - what docs exist +3. [FLAGS.md](FLAGS.md) - known gaps / accepted limitations +4. Task docs linked from INDEX (onboarding, deploy, architecture) only as needed +5. [README.md](README.md) - how to run and contribute + +Do not auto-load `docs/archive/`. Do not invent a business FMD suite (no BRD / UES / GTM). + +## Conventions + +- Challenge/event tool posture: Archive unless preparing a new rush. +- Do not invent GTM or product-suite docs. +- Docs-only improvements land as FLAGS unless maintainers explicitly ask for code changes. +- No em-dashes in new docs. + +## Ownership + +Owner: GDG PUP Technology (incoming CTO). Handover 2026-09-02. Outgoing CTO: Carlos Jerico Dela Torre. \ No newline at end of file diff --git a/FLAGS.md b/FLAGS.md new file mode 100644 index 0000000..da4a3a5 --- /dev/null +++ b/FLAGS.md @@ -0,0 +1,11 @@ +# FLAGS + +Improvement register for this repository. Documentation handover only - do not treat Open rows as bugs fixed in the docs PR. + +Status: **Open** (actionable later) or **Accepted** (known limitation). + + +| ID | Severity | Finding | Evidence | Suggested next step | Status | +| --- | --- | --- | --- | --- | --- | +| F1 | Medium | Firebase env vars are required; README lists a partial set. | README Environment Setup | Publish a complete env name list (no secrets) before the next event. | Open | +| F2 | Low | Package name is ``css-rush`` while repo/title is Code Rush. | ``package.json`` | Harmless naming drift; align only if republishing. | Accepted | \ No newline at end of file diff --git a/README.md b/README.md index d21c427..4326c91 100644 --- a/README.md +++ b/README.md @@ -85,3 +85,21 @@ If you encounter any issues or have questions, please [open an issue](https://gi ## 📄 License Distributed under the MIT License. See [LICENSE](LICENSE) for more information. + +--- + +## Documentation + +- [docs/state.md](docs/state.md) - Operating position / handover +- [docs/index.md](docs/index.md) - Doc inventory +- [FLAGS.md](FLAGS.md) - Improvement register +- [AGENTS.md](AGENTS.md) - Agent load order + +## Contributors + +This project is made possible by the GDG PUP community: + +| Role | Name | +| --- | --- | +| 💻 **Development** | [Erwin Daguinotas](https://www.linkedin.com/in/erwin-daguinotas) - Web Development Lead | +| 💻 **Development** | [Gerald Berongoy](https://www.linkedin.com/in/geraldberongoy) - Senior Backend Developer / Web Development Learning Head | diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..bd9025f --- /dev/null +++ b/docs/index.md @@ -0,0 +1,23 @@ +# Documentation Index: Code Rush + +**Project slug:** `code-rush` +**Maintained by:** GDG PUP Technology (incoming CTO) +**Last updated:** 2026-09-02 + +**Operating position:** [state.md](state.md) - read that first. + +## 1. Artifact Inventory + +List only artifacts that exist. + +| Artifact | File | Version | Status | Last Updated | Last Reconciled | +| --- | --- | --- | --- | --- | --- | +| STATE | [state.md](state.md) | 1.0 | Current | 2026-09-02 | 2026-09-02 | +| FLAGS | [../FLAGS.md](../FLAGS.md) | 1.0 | Current | 2026-09-02 | 2026-09-02 | +| AGENTS | [../AGENTS.md](../AGENTS.md) | 1.0 | Current | 2026-09-02 | 2026-09-02 | +| README | [../README.md](../README.md) | - | Current | 2026-09-02 | 2026-09-02 | + + +## 2. Notes + +INDEX is inventory only. STATE is position. FLAGS holds improvement backlog. No BRD/UES/GTM suite for this handover. \ No newline at end of file diff --git a/docs/state.md b/docs/state.md new file mode 100644 index 0000000..101be3d --- /dev/null +++ b/docs/state.md @@ -0,0 +1,27 @@ +# Project State: Code Rush + +**Project slug:** `code-rush` +**Owner:** GDG PUP Technology (incoming CTO) +**Last updated:** 2026-09-02 +**Milestone:** Archive + +## Position + +Interactive **CSS speed-run / challenge** experience (``css-rush``) for GDG on Campus PUP campus showdowns: drag-and-drop CSS challenges, previews, and Firebase-backed leaderboards. + +Milestone: **Archive** as an event/challenge tool after the rush; redeploy when hosting another Code Rush. + +Handover date: 2026-09-02. Outgoing CTO: Carlos Jerico Dela Torre. + +## Read first + +1. [state.md](state.md) (this file) +2. [index.md](index.md) +3. [../FLAGS.md](../FLAGS.md) +4. [../README.md](../README.md) +5. [../AGENTS.md](../AGENTS.md) + +## Notes + +- Event/challenge tool for GDG PUP competitive CSS activities (Spark Rush mode referenced in README). +- Requires Firebase env configuration to run fully. \ No newline at end of file From d52b1ac139ec7d0bca0ebea3dc9a11932c90d575 Mon Sep 17 00:00:00 2001 From: delatorrecj Date: Wed, 2 Sep 2026 23:38:58 +0800 Subject: [PATCH 2/2] docs: stamp FMD v1.31.0 on INDEX and AGENTS Record Built on FMD v1.31.0 (suite) or FMD philosophy (v1.31.0) so humans and AI know the control-plane version. Co-authored-by: Cursor --- AGENTS.md | 7 ++++++- docs/index.md | 5 +++-- 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 9eadaa3..edb30ec 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,4 +21,9 @@ Do not auto-load `docs/archive/`. Do not invent a business FMD suite (no BRD / U ## Ownership -Owner: GDG PUP Technology (incoming CTO). Handover 2026-09-02. Outgoing CTO: Carlos Jerico Dela Torre. \ No newline at end of file +Owner: GDG PUP Technology (incoming CTO). Handover 2026-09-02. Outgoing CTO: Carlos Jerico Dela Torre. +## FMD + +**Built on FMD philosophy (v1.31.0)** - INDEX / STATE / FLAGS control plane for humans and AI; no FMD engine install. + +Read order stays: docs/state.md then docs/index.md then FLAGS.md then task docs. diff --git a/docs/index.md b/docs/index.md index bd9025f..1edfff4 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,8 +1,9 @@ -# Documentation Index: Code Rush +# Documentation Index: Code Rush **Project slug:** `code-rush` **Maintained by:** GDG PUP Technology (incoming CTO) **Last updated:** 2026-09-02 +**Built on FMD philosophy (v1.31.0)** - INDEX / STATE / FLAGS control plane for humans and AI; no FMD engine install. **Operating position:** [state.md](state.md) - read that first. @@ -20,4 +21,4 @@ List only artifacts that exist. ## 2. Notes -INDEX is inventory only. STATE is position. FLAGS holds improvement backlog. No BRD/UES/GTM suite for this handover. \ No newline at end of file +INDEX is inventory only. STATE is position. FLAGS holds improvement backlog. No BRD/UES/GTM suite for this handover.