From 885148d06025437e360a11bf14ce038f0980e0b4 Mon Sep 17 00:00:00 2001
From: Mercy017 <279566419+Mercy017@users.noreply.github.com>
Date: Fri, 19 Jun 2026 15:37:37 +0100
Subject: [PATCH] docs(readme): document the GrantFox Roadmap project board &
 workflow

Add a Project Board section to the README's Contributing area: the board
columns (Backlog -> Up for Grabs -> In Progress -> In Review -> Done), the
automation rules (new issue -> Backlog, good first issue -> Up for Grabs,
PR opened -> In Progress, merged -> Done), and a link to the board.

Addresses the 'README links to board' acceptance criterion of #20. Creating
the org board, triaging the 20 issues, and wiring the automation require
maintainer/admin access and remain maintainer tasks.

Part of #20
---
 README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/README.md b/README.md
index 47ab781..c26f0b2 100644
--- a/README.md
+++ b/README.md
@@ -362,6 +362,26 @@ SecureFlow is an open-source project growing beyond the hackathon. We welcome co
 3. Make your changes (run `npm run lint` and `npm test` before pushing)
 4. Open a PR against `main`
 
+### Project Board
+
+Track what's available, in progress, and done on the **[SecureFlow — GrantFox Roadmap](https://github.com/orgs/Secureflow-protocol/projects)** board. It's the fastest way to see where to jump in.
+
+The board flows left to right:
+
+| Column           | What it means                                               |
+| ---------------- | ----------------------------------------------------------- |
+| **Backlog**      | Triaged, but not yet ready to pick up                       |
+| **Up for Grabs** | Ready to claim — look for `good first issue` to get started |
+| **In Progress**  | Actively being worked on (a PR is open)                     |
+| **In Review**    | PR is open and awaiting maintainer review                   |
+| **Done**         | Merged and shipped                                          |
+
+Automation keeps it in sync, so you rarely have to move cards by hand:
+
+- A **new issue** is added to **Backlog**; issues labelled `good first issue` move to **Up for Grabs**.
+- Opening a **PR** moves its linked issue to **In Progress**.
+- A **merged** PR moves the issue to **Done**.
+
 ### Labels
 
 | Label              | Meaning                                |