Skip to content

docs: route newcomers to hosted Genesis Console #1493

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MontrealAI wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: route newcomers to hosted Genesis Console #1493

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 25 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,19 @@

AGIJobManager is an Ethereum smart-contract system for escrowed AGI work agreements, with optional ENS-backed job pages managed by `ENSJobPages`.

> [!IMPORTANT]
> **New here? Start with the [Genesis Console](https://montrealai.github.io/agijobmanagerv0.html).**
> This is the fastest operator/reviewer entry point for the standalone mainnet UI.
> **Repo-pinned equivalent artifact:** `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`
> **Operator guide:** `docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`
Comment on lines +14 to +15
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Align README with the documented standalone artifact

This change reroutes newcomers to v33, but a repo-wide rg -n 'v33|v21|Genesis Console' docs ui still shows every operator runbook and inventory treating v21 as the canonical standalone artifact (docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md:1-17, docs/ui/STANDALONE_HTML_UIS.md:9-20, ui/README.md:17-33). Because v21 and v33 are different files, operators who follow the new README path will be inspecting an interface that has no matching runbook/troubleshooting docs, which makes the main entrypoint internally inconsistent and easy to use incorrectly.

Useful? React with 👍 / 👎.


### Quick links

- **Launch Genesis Console:** <https://montrealai.github.io/agijobmanagerv0.html>
- **Read the operator guide:** `docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`
- **Inspect the pinned standalone artifact:** `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`
- **Deployment / contract operations:** `hardhat/README.md` and `docs/DEPLOYMENT/README.md`

> **Operational policy:** intended for autonomous AI-agent execution with accountable human owner/operator oversight. This is policy intent and is not fully enforced on-chain.

## Start here by role (30-second routing)
Expand All @@ -16,7 +29,7 @@ AGIJobManager is an Ethereum smart-contract system for escrowed AGI work agreeme
- **Contract owner (Etherscan-first):** start with [`docs/DEPLOYMENT/OWNER_MAINNET_DEPLOYMENT_AND_OPERATIONS_GUIDE.md`](docs/DEPLOYMENT/OWNER_MAINNET_DEPLOYMENT_AND_OPERATIONS_GUIDE.md), then [`docs/OWNER_RUNBOOK.md`](docs/OWNER_RUNBOOK.md).
- **ENSJobPages replacement operator:** use one canonical flow in [`docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md`](docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md).
- **Troubleshooting during deployment/cutover:** go to [`docs/TROUBLESHOOTING_DEPLOYMENT_AND_ENS.md`](docs/TROUBLESHOOTING_DEPLOYMENT_AND_ENS.md).
- **Standalone HTML UI operator/reviewer:** start with [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md), then [`docs/ui/STANDALONE_HTML_UIS.md`](docs/ui/STANDALONE_HTML_UIS.md) and [`ui/README.md`](ui/README.md) for UI surface inventory.
- **Standalone HTML UI operator/reviewer:** start with the [Genesis Console](https://montrealai.github.io/agijobmanagerv0.html), then read [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md). For the repo-pinned standalone artifact, see [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html).
- **Broader/full UI contributor:** use [`docs/ui/README.md`](docs/ui/README.md) for Next.js UI roadmap, runbooks, and release/testing docs.

## Canonical operator answers (quick reference)
Expand Down Expand Up @@ -57,16 +70,17 @@ Irreversible actions (delay until validated):
- **Smart contracts (authoritative protocol state):** `contracts/` (AGIJobManager + ENSJobPages integration).
- **Deployment/operator tooling (official):** `hardhat/` with runbooks in `docs/DEPLOYMENT/`.
- **ENS identity layer (additive):** ENSJobPages docs in `docs/ENS/` and replacement flow in `docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md`.
- **Standalone HTML UI artifact (versioned):** `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v21.html` with operator guide at [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) and artifact index [`docs/ui/STANDALONE_HTML_UIS.md`](docs/ui/STANDALONE_HTML_UIS.md).
- **Standalone Genesis Console surfaces:** canonical newcomer entry is the hosted Genesis Console at <https://montrealai.github.io/agijobmanagerv0.html>; repo-pinned versioned standalone artifact is [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html); operator guide is [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md); artifact inventory and broader UI references are [`docs/ui/STANDALONE_HTML_UIS.md`](docs/ui/STANDALONE_HTML_UIS.md), [`ui/README.md`](ui/README.md), and [`docs/ui/README.md`](docs/ui/README.md).
- **Broader/full UI in development:** Next.js app and UI docs in [`ui/`](ui/) and [`docs/ui/README.md`](docs/ui/README.md).

### UI routing (pick the right interface quickly)

| If you need to... | Use this | Why |
| --- | --- | --- |
| Operate a versioned single-file mainnet interface | [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v21.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v21.html) + [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) | Fast, standalone browser artifact for direct operator/reviewer workflows. |
| Build/test the broader UI stack | [`ui/`](ui/) + [`docs/ui/README.md`](docs/ui/README.md) | Full Next.js UI effort, still in active development. |
| Deploy/replace contracts and ENS components | [`hardhat/README.md`](hardhat/README.md) + [`docs/DEPLOYMENT/README.md`](docs/DEPLOYMENT/README.md) | Canonical deployment and operator runbooks; UI is not a deployment substitute. |
| Operate the mainnet standalone interface right now | <https://montrealai.github.io/agijobmanagerv0.html> + [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md) | Fastest newcomer/operator entry point for the standalone mainnet console. |
| Inspect the pinned standalone artifact in-repo | [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html) | Repo-pinned equivalent artifact for review, provenance, and versioned inspection. |
| Build/test the broader UI stack | [`ui/`](ui/) + [`docs/ui/README.md`](docs/ui/README.md) | Broader UI effort and development docs. |
| Deploy/replace contracts and ENS components | [`hardhat/README.md`](hardhat/README.md) + [`docs/DEPLOYMENT/README.md`](docs/DEPLOYMENT/README.md) | Canonical deployment/operator runbooks; UI is not a deployment substitute. |

> **UI safety boundary:** the standalone HTML artifact is action-capable, but contract deployment, ownership wiring, and ENS replacement authority remain in Hardhat/deployment runbooks.

Expand All @@ -85,7 +99,9 @@ Irreversible actions (delay until validated):
- ENSJobPages replacement runbook (mainnet): [`docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md`](docs/DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md)
- ENS naming/behavior reference: [`docs/ENS/ENS_JOB_PAGES_OVERVIEW.md`](docs/ENS/ENS_JOB_PAGES_OVERVIEW.md)
- Deployment troubleshooting: [`docs/TROUBLESHOOTING_DEPLOYMENT_AND_ENS.md`](docs/TROUBLESHOOTING_DEPLOYMENT_AND_ENS.md)
- Standalone HTML UI (v21) operator guide: [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md)
- Genesis Console (hosted newcomer entry): <https://montrealai.github.io/agijobmanagerv0.html>
- Genesis Console operator guide: [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md)
- Pinned standalone artifact (repo): [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html)
- UI directory inventory: [`ui/README.md`](ui/README.md)

## Recommended vs legacy deployment paths
Expand Down Expand Up @@ -161,7 +177,9 @@ npm run docs:ens:check

- Main documentation index: [`docs/README.md`](docs/README.md)
- UI docs hub (broader UI): [`docs/ui/README.md`](docs/ui/README.md)
- Standalone HTML UI guide (v21): [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md)
- Genesis Console operator guide: [`docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`](docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md)
- Genesis Console (hosted newcomer entry): <https://montrealai.github.io/agijobmanagerv0.html>
- Pinned standalone artifact (repo): [`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html`](ui/agijobmanager_genesis_job_mainnet_2026-03-05-v33.html)
- UI directory inventory: [`ui/README.md`](ui/README.md)
- Quintessential walkthrough: [`docs/QUINTESSENTIAL_USE_CASE.md`](docs/QUINTESSENTIAL_USE_CASE.md)

Expand Down
Loading