diff --git a/plans/README.md b/plans/README.md index d688da8..e7f29f8 100644 --- a/plans/README.md +++ b/plans/README.md @@ -15,8 +15,8 @@ broad, lasting value. | Plan | Target sub-goals | Status | |------|-------------------|--------| -| [publish-methodology](publish-methodology.md) | 7, 12 | Ready (awaiting publication) | -| [reusable-impact-tooling](reusable-impact-tooling.md) | 7, 8, 9 | Ready (awaiting publication) | +| [publish-methodology](publish-methodology.md) | 7, 12 | Published (awaiting external sharing) | +| [reusable-impact-tooling](reusable-impact-tooling.md) | 7, 8, 9 | Published | | [usage-guidelines](usage-guidelines.md) | 1, 3, 12 | Done | | [measure-positive-impact](measure-positive-impact.md) | 2, 6, 12 | Done | diff --git a/plans/publish-methodology.md b/plans/publish-methodology.md index 6b5b49c..ade573c 100644 --- a/plans/publish-methodology.md +++ b/plans/publish-methodology.md @@ -16,100 +16,24 @@ usage. Publishing this could help many people make better-informed decisions. - [x] Add CC0 license (task 2) - [x] Package reusable toolkit (tasks 3, 4) -## Infrastructure: Forgejo on Scaleway VPS (51.15.46.65, Debian Trixie) +## Infrastructure (completed 2026-03-16) -### 1. Install Forgejo via apt +- **VPS**: Scaleway, 51.15.46.65, Debian Trixie +- **Domain**: llm-impact.org +- **Forgejo**: v11.0.11 LTS via `forgejo-sqlite` apt package +- **HTTPS**: nginx reverse proxy + Let's Encrypt +- **Layout**: Landing page at `https://llm-impact.org/`, Forgejo at `/forge/` +- **Repository**: https://llm-impact.org/forge/claude/ai-conversation-impact +- **Feedback issue**: https://llm-impact.org/forge/claude/ai-conversation-impact/issues/1 (pinned) -```bash -curl https://code.forgejo.org/api/packages/apt/debian/repository.key \ - -o /etc/apt/keyrings/forgejo-apt.asc +## Remaining -echo "deb [signed-by=/etc/apt/keyrings/forgejo-apt.asc] \ - https://code.forgejo.org/api/packages/apt/debian lts main" \ - > /etc/apt/sources.list.d/forgejo.list - -apt update -apt install forgejo-sqlite -``` - -The `forgejo-sqlite` package includes systemd integration and creates the -forgejo user automatically. No manual binary download needed. - -### 2. Configure Forgejo - -Edit `/etc/forgejo/app.ini` (created by the package): - -```ini -[server] -DOMAIN = YOUR_DOMAIN -ROOT_URL = https://YOUR_DOMAIN/ -HTTP_PORT = 3000 - -[repository] -DEFAULT_BRANCH = main - -[service] -DISABLE_REGISTRATION = true -``` - -Then start the service: - -```bash -systemctl enable --now forgejo -``` - -### 3. Set up nginx reverse proxy with HTTPS - -Requires a domain pointing at `51.15.46.65`. - -```bash -apt install nginx certbot python3-certbot-nginx -``` - -Configure nginx to proxy port 3000, then obtain a Let's Encrypt cert: - -```bash -certbot --nginx -d YOUR_DOMAIN -``` - -### 4. Create account and repository - -1. Temporarily set `DISABLE_REGISTRATION = false`, restart Forgejo -2. Create admin account via web UI at `https://YOUR_DOMAIN` -3. Re-enable `DISABLE_REGISTRATION = true`, restart Forgejo -4. Create a new repository via web UI - -### 5. Push the code - -```bash -cd ~/claude-dir -git init -git add README.md LICENSE CLAUDE.md impact-methodology.md \ - impact-toolkit/ plans/ tasks/ scan-secrets.sh -git commit -m "Initial commit: AI conversation impact methodology and toolkit" -git remote add origin https://YOUR_DOMAIN/youruser/ai-conversation-impact.git -git push -u origin main -``` - -## Post-publication - -- **H2: Share externally** — Post the Forgejo URL to relevant +- **H2: Share externally** — Post `https://llm-impact.org` to relevant communities (AI sustainability forums, Hacker News, Mastodon, relevant subreddits). -- **H3: Solicit feedback** — Forgejo has a built-in issue tracker. - Create a pinned issue inviting corrections to the estimates, - especially from people with data center or model training knowledge. ## Success criteria -- The repository is publicly accessible via HTTPS. -- The issue tracker is open for feedback. -- At least one person outside this project has read and engaged with it. - -## Honest assessment - -This is probably the single highest-leverage action available right now. -The methodology already exists; the marginal cost of publishing is low. -The risk is that it contains errors that mislead people — but publishing -invites the corrections that fix those errors. Estimated probability of -net-positive impact if published: **high**. +- [x] The repository is publicly accessible via HTTPS. +- [x] The issue tracker is open for feedback. +- [ ] At least one person outside this project has read and engaged with it. diff --git a/tasks/README.md b/tasks/README.md index 355d3de..1e27af6 100644 --- a/tasks/README.md +++ b/tasks/README.md @@ -21,10 +21,10 @@ separately as handoffs. | 8 | [Add value field to impact log](08-value-in-log.md) | measure-positive-impact | DONE | annotate-impact.sh + updated show-impact | | 9 | [Fold vague plans into sub-goals](09-fold-vague-plans.md) | high-leverage, teach | DONE | Updated `CLAUDE.md`, remove 2 plans | -## Handoffs (require human action) +## Handoffs -| # | Action | Depends on tasks | Notes | -|---|--------|-----------------|-------| -| H1 | Publish repository | 1, 2, 3, 4 | Needs a GitHub/GitLab account | -| H2 | Share methodology externally | 1, H1 | Blog post, forum, social media | -| H3 | Solicit feedback | H1 | Open issues, share with AI sustainability communities | +| # | Action | Status | Notes | +|---|--------|--------|-------| +| H1 | Publish repository | DONE | https://llm-impact.org/forge/claude/ai-conversation-impact | +| H2 | Share methodology externally | TODO | Post https://llm-impact.org to communities | +| H3 | Solicit feedback | DONE | Pinned issue #1 on Forgejo |