convez.ai
PluginAutomaçãoAvançado
ordinary9843

Gitizens — Uma Nação Governada pelo GitHub

ordinary9843/gitizens

Nação descentralizada onde reações são votos e commits são leis

Ver no GitHub
BomPluginScore · de 0 a 100

Um experimento de governança descentralizada que simula uma cidade inteira rodando como repositório GitHub. Cidadãos votam via reações em Issues, leis são propostas e aprovadas por reações, e o mundo evolui automaticamente a cada 2 horas sem necessidade de servidor central. Combina gamificação, política e automação de forma única.

Instalação

$npx convez-ai ordinary9843/gitizens

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
0
Acompanhando
1
Saúde
57%
Último commit
há 1 dia
Versão
—
Issues abertas
5
Contribuidores
1

Casos de uso

  • Experimentar governança descentralizada e votação participativa
  • Criar comunidades gamificadas com mecânicas de simulação de cidades
  • Demonstrar automação completa via GitHub Actions sem infraestrutura externa
  • Educação sobre processos democráticos e impacto de políticas em sistemas complexos

Veredito

Projeto ambicioso e criativo que usa GitHub como infraestrutura de governança real. Requer compreensão profunda de GitHub Actions, web scraping de reações e simulações de estado, mas oferece um modelo único de DAO descentralizado sem smart contracts.

README

A tradução para o português deste README ainda está na fila.


What is Gitizens?

Tests Coverage

GitHub Issues are laws. Reactions are votes. Every 2 hours, the world ticks forward on its own.

Buildings emerge when policy metrics cross thresholds. Random events strike. Eras rise and fall.
No admin. No server. Just a repo, some GitHub Actions, and the citizens who vote.

→ Watch the live city on GitHub Pages


Current World Status

Era Population Treasury Stability Pollution Laws

Era: Founding Era | Laws enacted: 14 | World state
Next tick: 2026-06-14T06:00:00Z UTC


Become a Citizen

  1. Star this repo — each star earns the treasury 10 Git Coins
  2. React to open proposals — 👍 to pass, 👎 to reject · Open proposals
  3. Propose a law — open the dashboard, fill in the PROPOSE A LAW form, and click Open Issue — GitHub pre-fills the title and body for you

No signup. No account. Just a GitHub account and an opinion.


How to Play

1. Watch the world

Open the live city dashboard. Every building reflects a real policy metric. The world ticks every 2 hours — even when no one is online.

2. Vote on proposals

Open any Issue labeled proposal. React with 👍 to vote for, 👎 to vote against. Voting closes in 24 hours.

3. Propose a law

Open the live dashboard and scroll to PROPOSE A LAW. Fill in a title, choose an effect type, describe your intent, and click Open Issue — the form pre-fills the GitHub Issue for you. Submit it and voting starts immediately.

Advanced: install claude-gitizens and run /gitizens:propose in Claude Code for a guided, AI-assisted proposal workflow.


World Mechanics

MechanicHow it works
Policy lawsChange education / industry / welfare / green_policy / defense (costs 100 Git Coins)
Idle growthWorld ticks every 2h regardless of votes — population grows, pollution drifts, stability shifts
Random events15% chance per tick — drought, stock crash, alien signal, pandemic, and 47 more
Era progressionFounding → Industrial → Modern → Golden Age (or Crisis Age if things go wrong)
TreasuryEarned from GitHub stars (×10 GC) + industrial output + population tax
BuildingsAuto-created/removed by the world engine based on metric thresholds

Ver o original no GitHub

Bom para

Relacionados