[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80925":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":15,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":24,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":39,"readmeContent":40,"aiSummary":41,"trendingCount":16,"starSnapshotCount":16,"syncStatus":14,"lastSyncTime":42,"discoverSource":43},80925,"genesis-architect","maioio\u002Fgenesis-architect","maioio","Research-first project scaffolding for Claude Code. Mines GitHub Issues for production failures before writing a single file.","https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect",null,"Python",42,6,2,5,0,8,10,15,2.54,"MIT License",false,"main",true,[26,27,28,29,30,31,32,33,34,35,36,37,38],"ai-tools","architecture","boilerplate","claude-code","claude-skill","code-generation","developer-tools","market-research","project-scaffold","project-setup","project-template","scaffold","scaffolding","2026-06-12 02:04:08","\u003Cdiv align=\"center\">\n\n# Genesis Architect\n\n**Most projects fail because developers repeat mistakes that were already solved in other repositories.**\n\nGenesis Architect scans GitHub before you write code. It finds the common failures, bugs, and design pitfalls\nthat real developers hit building the same thing - then generates a scaffold with those mitigations already built in.\n\n[![CI](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fmaioio\u002Fgenesis-architect\u002Fci.yml?branch=main&style=for-the-badge&label=CI)](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Factions)\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-5.1.1-blue?style=for-the-badge)](CHANGELOG.md)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green?style=for-the-badge)](LICENSE)\n[![Claude Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude_Code-skill-orange?style=for-the-badge)](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code)\n[![Known Vulnerabilities](https:\u002F\u002Fsnyk.io\u002Ftest\u002Fgithub\u002Fmaioio\u002Fgenesis-architect\u002Fbadge.svg?style=for-the-badge)](https:\u002F\u002Fsnyk.io\u002Ftest\u002Fgithub\u002Fmaioio\u002Fgenesis-architect)\n\n[![Quality Gate](https:\u002F\u002Fsonarcloud.io\u002Fapi\u002Fproject_badges\u002Fmeasure?project=maioio_genesis-architect&metric=alert_status)](https:\u002F\u002Fsonarcloud.io\u002Fsummary\u002Fnew_code?id=maioio_genesis-architect)\n[![Security Rating](https:\u002F\u002Fsonarcloud.io\u002Fapi\u002Fproject_badges\u002Fmeasure?project=maioio_genesis-architect&metric=security_rating)](https:\u002F\u002Fsonarcloud.io\u002Fsummary\u002Fnew_code?id=maioio_genesis-architect)\n[![Maintainability](https:\u002F\u002Fsonarcloud.io\u002Fapi\u002Fproject_badges\u002Fmeasure?project=maioio_genesis-architect&metric=sqale_rating)](https:\u002F\u002Fsonarcloud.io\u002Fsummary\u002Fnew_code?id=maioio_genesis-architect)\n[![Coverage](https:\u002F\u002Fsonarcloud.io\u002Fapi\u002Fproject_badges\u002Fmeasure?project=maioio_genesis-architect&metric=coverage)](https:\u002F\u002Fsonarcloud.io\u002Fsummary\u002Fnew_code?id=maioio_genesis-architect)\n\n[![Phases](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fphases-9-blueviolet?style=flat-square)](SKILL.md)\n[![Languages](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flanguages-4-informational?style=flat-square)](references\u002Farchitecture-patterns.md)\n[![Archetypes](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Farchetypes-4-success?style=flat-square)](SKILL.md)\n[![Tests](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftests-386-brightgreen?style=flat-square)](tests\u002F)\n[![Eval accuracy](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Feval_accuracy-100%25-brightgreen?style=flat-square)](evals\u002Ftest_queries.json)\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fmaioio\u002Fgenesis-architect?style=social)](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Fstargazers)\n\n[![GitHub Sponsors](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor-%23EA4AAA?style=flat-square&logo=github-sponsors)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fmaioio)\n[![Buy Me a Coffee](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBuy_Me_a_Coffee-%23FFDD00?style=flat-square&logo=buy-me-a-coffee&logoColor=black)](https:\u002F\u002Fbuymeacoffee.com\u002Fmaioio)\n\n\u003Cbr\u002F>\n\n\u003Cimg src=\"docs\u002Fassets\u002Fdemo.gif\" alt=\"Genesis Architect demo\" width=\"700\"\u002F>\n\n**If this saved you from a bad architecture decision - [star it](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Fstargazers). It helps others find it.**\n\n\u003C\u002Fdiv>\n\n---\n\n## What it actually produces\n\nRun: `genesis init a Python CLI for analyzing log files`\n\n**Pitfalls found from real GitHub Issues (before a single file is written):**\n\n| # | Issue | Found in | Root cause | Built-in mitigation |\n|---|-------|----------|-----------|---------------------|\n| 1 | [pallets\u002Fclick#2416](https:\u002F\u002Fgithub.com\u002Fpallets\u002Fclick\u002Fissues\u002F2416) | 4\u002F5 repos | Business logic inside Click callback - untestable | `cli.py` only parses args, all logic in `core.py` |\n| 2 | [pallets\u002Fclick#2558](https:\u002F\u002Fgithub.com\u002Fpallets\u002Fclick\u002Fissues\u002F2558) | 3\u002F5 repos | Type stubs change in Click 8.1.4 breaks mypy silently | Pin `click>=8.1.7`, `# type: ignore` only where needed |\n| 3 | [pallets\u002Fclick#1846](https:\u002F\u002Fgithub.com\u002Fpallets\u002Fclick\u002Fissues\u002F1846) | 3\u002F5 repos | Raw file path from CLI args allows `..\u002F..\u002F..\u002Fetc\u002Fpasswd` | `get_safe_path(base, user_input)` in `utils\u002Fsecurity.py` |\n| 4 | [fastapi\u002Ftyper#522](https:\u002F\u002Fgithub.com\u002Ffastapi\u002Ftyper\u002Fissues\u002F522) | 5\u002F5 repos | No input validation produces cryptic tracebacks as errors | `click.BadParameter` at entry point before any processing |\n\n**Scaffold generated (12 files, 0 empty stubs):**\n\n```\nlog-analyzer\u002F\n├── src\u002Flog-analyzer\u002F\n│   ├── __init__.py\n│   ├── main.py        # Click CLI - args only, delegates to core\n│   ├── core.py        # All logic lives here, testable without subprocess\n│   └── utils\u002F\n│       └── security.py  # get_safe_path() - path traversal guard\n├── tests\u002F\n│   ├── __init__.py\n│   └── test_core.py   # Tests core directly, no subprocess needed\n├── .github\u002Fworkflows\u002Fci.yml  # 4 jobs: tests, secrets, SAST, quality gate\n├── .env.example\n├── pyproject.toml     # click>=8.1.7 pinned, mypy strict, pytest config\n├── RESEARCH.md        # 5 repos analyzed, all sources verified live\n├── PITFALLS.md        # The 4 pitfalls above with full root cause analysis\n└── ROADMAP.md         # 5-phase plan: scaffold -> tests -> CI -> quality -> ship\n```\n\nEvery cited issue URL is verified by CI. A 404 fails the build.\n\n---\n\n## When NOT to use Genesis\n\n> Honesty matters. Genesis is overkill for some things.\n\n**Skip Genesis if you are building:**\n- A tiny script (under 100 lines, no tests needed)\n- A throwaway experiment or one-off utility\n- A single-file tool you will delete in a week\n- Something with zero external dependencies\n\n**Use Genesis if you are building:**\n- A project you plan to maintain for more than a month\n- Anything with authentication, file I\u002FO, or external APIs\n- A library or SDK other people will depend on\n- Something you want to ship without hitting the same bugs everyone else hit\n\n---\n\n## Install\n\n```bash\n# Claude Code (recommended)\ngit clone https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect ~\u002F.claude\u002Fskills\u002Fgenesis-architect\n\n# Cursor\n# Copy SKILL.md to .cursor\u002Frules\u002Fgenesis-architect.md\n\n# Codex CLI\ngit clone https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect ~\u002F.codex\u002Fskills\u002Fgenesis-architect\n```\n\nNo build step, no dependencies.\n\n---\n\n## Usage\n\n```bash\n# Full research mode (default) - 15-20 repos, full Issue mining\ngenesis init a REST API in TypeScript\ngenesis init a Python CLI for batch image processing\ngenesis init a Chrome extension that does X\n\n# Fast MVP mode - research capped at 5 min, then immediately builds\ngenesis init --fast-mvp a Discord bot in Python\n\n# Development Partner Mode - asks before every major decision\ngenesis init --partner a SaaS billing system\n\n# Read a product spec, skip the questions\ngenesis init --from-prd PRD.md\n\n# Audit an existing project\ngenesis audit .\u002Fmy-existing-project\n\n# Inject security gates into any project\ngenesis harden .\u002Fmy-existing-project\n\n# Smart Resolution with local vault\ngenesis resolve path traversal python\n```\n\nOr just describe what you want:\n\n```\nI want to build a Telegram bot\nscaffold a new project for web scraping\nstart building a VS Code extension\n```\n\n---\n\n## How it works\n\nBefore writing a single file, Genesis runs research across real GitHub repos:\n\n1. **Finds 15-20 repos** similar to what you are building (filtered by stars, recency, language)\n2. **Mines GitHub Issues** from the top repos - up to 50 closed issues each - extracting recurring failures, security patches, and architecture regrets\n3. **Synthesizes the wise average** of what actually survives in production across those repos\n4. **Generates a scaffold** where every pitfall found becomes a concrete code task - not a document to read later\n\nThe difference from templates: the scaffold reflects what broke for the people who built this before you.\n\n---\n\n## Fast MVP mode\n\n```bash\ngenesis init --fast-mvp a REST API\n```\n\nResearch is capped at 5 minutes, 10 repos, 30 issues. Genesis then immediately builds instead of asking questions. Output is a single `BUILD_PACKET.md` with each pitfall as a concrete code task, plus the full scaffold.\n\nUse this when you want a running project in under 10 minutes and are willing to trade some research depth.\n\n---\n\n## Development Partner Mode\n\nGenesis V5.1 does not make major decisions silently.\n\nBefore choosing an architecture, defining MVP scope, selecting a technology, or making a product direction call - Genesis presents options, explains the tradeoff, and waits.\n\n**The rule:** fewer, better-timed questions. Not more questions. Less rework.\n\n### Experience Selection\n\nWhen you describe a project in natural language, Genesis asks once:\n\n```\nWhat kind of Genesis experience?\n\nA: Fast Build     - quick MVP, minimal questions (hackathon \u002F experiment)\nB: Professional   - structured research and validation  [Recommended]\nC: Founder        - market research, competitor analysis, product strategy\nD: Auto           - Genesis infers from your description and announces its choice\n```\n\nPick your mode once. Genesis adjusts research depth, question count, and output files accordingly.\n\n### Question format for major decisions\n\nWhen Genesis needs your input on something that matters:\n\n```\nShould this API use a database or in-memory state?\n\nA: In-memory dict       - zero dependencies, no persistence across restarts\nB: SQLite               - file-based, no server needed, survives restarts\nC: PostgreSQL           [Recommended]\nD: Let me decide later\n\nWhy C: 3 of 5 analyzed repos moved from SQLite to Postgres under load - migration cost is high.\nRisk if you choose B: you will likely migrate later when concurrent writes break.\nPress Enter to accept C, or type A\u002FB\u002FD.\n```\n\n### What Genesis asks before vs. what it decides alone\n\n| Genesis MUST ask before | Genesis decides alone |\n|---|---|\n| Architecture: Minimalist vs Scalable | File names |\n| MVP scope: what is in \u002F what is out | Folder structure details |\n| Technology: when tradeoffs are real | Formatting and linting choices |\n| Product direction: target user, pivots | Small implementation details |\n| Business: monetization, open vs commercial | Internal refactors |\n\n### Companion Mode stays active\n\nDevelopment Partner rules do not expire after the scaffold. They remain active through Phase 7 (Companion Mode) for the lifetime of the project.\n\n---\n\n## What every project gets\n\n| Deliverable | Contents |\n|-------------|----------|\n| `RESEARCH.md` | 15-20 repos scanned, top repos deeply analyzed, sources linked |\n| `PITFALLS.md` | 3-7 real pitfalls from GitHub Issues with root causes and mitigations |\n| `ROADMAP.md` | 5-10 phase development plan |\n| `src\u002F` | Functional code - not empty stubs |\n| `tests\u002F` | Passing unit tests for core logic |\n| `.github\u002Fworkflows\u002Fci.yml` | 4 parallel jobs: tests, secret scanning, SAST, code quality gate |\n| `utils\u002Fsecurity.py` or `security.ts` | `get_safe_path` guard for all file I\u002FO (when applicable) |\n| `docs\u002Fadr\u002F001-initial-architecture.md` | Every architectural decision explained with evidence |\n| `.gitignore` | Language-appropriate, hardened against secrets and build artifacts |\n| `.pre-commit-config.yaml` | Genesis enforcement hooks: mitigation enforcer + drift detector |\n\n**Production defaults baked into every scaffold:**\n\n| Default | What it does |\n|---------|-------------|\n| Structured logging | `pino`\u002F`winston`\u002F`slog` from line 1 - no `console.log` in production |\n| Non-root Dockerfile | `USER 1001` - never runs as root |\n| Env validation | Fails loudly at startup if required vars are missing |\n| `GET \u002Fhealth` | Returns `{\"status\":\"ok\"}` (Web Service archetype) |\n| No wildcard CORS | Explicitly listed origins only |\n| Secret Zero | `.env.example` with generation hint, validated at startup |\n| Secret scanning CI | Every push scanned - build fails on exposed credentials |\n| SAST analysis CI | Static analysis catches injection and path traversal on every push |\n\n---\n\n## How it compares\n\nEvery other tool - `create-t3-app`, `bolt.new`, Copilot Workspace, Cookiecutter - generates code from templates. They have no idea what broke in production for the developers who built the same thing before you.\n\n| Capability | Genesis Architect | create-t3-app | bolt.new | Cursor Rules |\n|-----------|:-----------------:|:-------------:|:--------:|:------------:|\n| Research from real GitHub Issues | Yes | No | No | No |\n| Validates citations (no hallucinated repos) | Yes | n\u002Fa | No | n\u002Fa |\n| Hard gates before file creation | Yes | No | No | No |\n| Development Partner Mode (asks before major decisions) | Yes | No | No | No |\n| Secret scanning + SAST on every scaffold | Yes | No | No | No |\n| Retrofit security into existing projects | Yes | No | No | No |\n| Smart Resolution Engine with local vault | Yes | No | No | No |\n| Stays active for entire project lifecycle | Yes | No | No | No |\n\n> Assessments based on public documentation as of 2026.\n\n---\n\n## Works at every level of MCP setup\n\n| Setup | Research quality | Speed |\n|-------|-----------------|-------|\n| No MCPs | Web search - real repos, shallower issue data | Normal |\n| GitHub MCP | Deep repo scan + real Issue extraction | Normal |\n| GitHub + Exa | Full parallel: repos + Reddit\u002FHN\u002FSO context | ~3x faster |\n| GitHub + Exa + Firecrawl | Full parallel + targeted page scraping | ~3x faster |\n\n> The skill never blocks on a missing tool. It reports what it is using and continues.\n\n---\n\n## Smart Resolution Engine\n\n`genesis resolve [topic]` checks a local vault first (instant, no API call), then falls back to Stack Overflow.\n\n```bash\n$ genesis resolve \"csv streaming large file python\"\n\nSmart Resolution Engine\nQuery: 'csv streaming large file python'\nSource: Stack Overflow community answers\n\n============================================================\nResult 1: Streaming CSV from S3 to Python\n  Score: 16  |  Answers: 5  |  Tags: python, boto3\n  [TOP ANSWER: score 11]  [type: classic]\n\n  Use chunked reading: read a block, find the last newline, process.\n  chunk_size = 1_000_000 ...\n\n  Source: https:\u002F\u002Fstackoverflow.com\u002Fa\u002F51142062\n============================================================\n\nIMPORTANT: Always review community solutions before applying.\nGenesis Architect never patches your code without your confirmation.\n```\n\nEvery resolved solution is saved to `.genesis\u002Fvault\u002F` and returned instantly on the next query.\n\nNo API key required (300 requests\u002Fday). Set `STACKOVERFLOW_KEY` for 10,000\u002Fday.\n\n---\n\n## Development Companion Mode\n\nAfter scaffolding, Genesis stays active for the rest of your session:\n\n```\ngenesis help I need to add rate limiting    -> searches Phase 2 repos for how they solved it\ngenesis research authentication patterns    -> targeted scan with 1-3 ranked approaches\ngenesis check                              -> freshness audit: CVEs, outdated deps, CI versions\ngenesis resolve path traversal python      -> Smart Resolution Engine with vault-first lookup\n```\n\n---\n\n## Languages and archetypes\n\n**Languages** auto-detected from research:\n\n```\nTypeScript \u002F JavaScript    Python    Go    Rust\n```\n\n**Archetypes** - each shapes the entire scaffold differently:\n\n| Archetype | Entrypoint | Has server | Has Dockerfile | Test runner |\n|-----------|-----------|-----------|----------------|-------------|\n| CLI Tool | `bin` \u002F `[project.scripts]` | No | Optional | pytest \u002F jest |\n| Library\u002FSDK | Public API, no `main()` | No | No | pytest \u002F jest |\n| Web Service\u002FAPI | Router | Yes | Yes + `\u002Fhealth` | pytest \u002F jest |\n| Frontend App | Component tree | No (SSR optional) | Optional | vitest \u002F jest |\n\n---\n\n## Real output - not fabricated\n\nFrom actual projects:\n\n**TypeScript CLI:**\n- [`examples\u002Ftypescript-cli\u002FRESEARCH.md`](examples\u002Ftypescript-cli\u002FRESEARCH.md) - 5 repos analyzed, every source linked and verified\n- [`examples\u002Ftypescript-cli\u002FPITFALLS.md`](examples\u002Ftypescript-cli\u002FPITFALLS.md) - 4 real pitfalls from live GitHub Issues\n- [`examples\u002Ftypescript-cli\u002FROADMAP.md`](examples\u002Ftypescript-cli\u002FROADMAP.md) - 5-phase plan calibrated to research findings\n\n**Python CLI:**\n- [`examples\u002Fpython-cli\u002FRESEARCH.md`](examples\u002Fpython-cli\u002FRESEARCH.md) - click, typer, python-fire, tqdm, prompt-toolkit analyzed\n- [`examples\u002Fpython-cli\u002FPITFALLS.md`](examples\u002Fpython-cli\u002FPITFALLS.md) - 4 pitfalls: click#2416, click#2558, tqdm#1139, typer#522 - all verified\n- [`examples\u002Fpython-cli\u002Fsrc\u002F`](examples\u002Fpython-cli\u002Fsrc\u002F) - working Python CLI with Click, get_safe_path, and full test suite\n\n---\n\n## What contributors found\n\n> First external contributor [@nitayk](https:\u002F\u002Fgithub.com\u002Fnitayk) opened 7 issues and submitted a 444-line PR with a self-contained code review - finding and fixing 4 bugs - within 48 hours of launch.\n\n---\n\n## Honest Limitations\n\n| Limitation | Details |\n|-----------|---------|\n| **Issue mining depth** | Scans up to 50 most-recent issues across repos. Low-traffic projects or old issues may not surface. |\n| **Web-search-only mode** | Without GitHub MCP, issue extraction is shallow. RESEARCH.md will note this automatically. |\n| **Stack Overflow API limit** | 300 requests\u002Fday unauthenticated. Set `STACKOVERFLOW_KEY` for 10,000\u002Fday. Vault hits bypass this entirely. |\n| **Fork intelligence** | Scanning active forks for upstream patches requires GitHub MCP. Without it, fork analysis is skipped. |\n| **WSL** | On Windows inside WSL, Linux paths and package managers are used - Windows PATH fixes do not apply. |\n\n---\n\n## Project structure\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Full layout\u003C\u002Fb>\u003C\u002Fsummary>\n\n```\ngenesis-architect\u002F\n├── SKILL.md                        # Skill definition - the brain\n├── plugin.json                     # Marketplace manifest\n├── scripts\u002F\n│   ├── scaffold_generator.py       # Creates project structure\n│   ├── research_validator.py       # Validates RESEARCH.md + live GitHub URL checks\n│   ├── resolve_engine.py           # Smart Resolution Engine (Stack Overflow API + vault)\n│   ├── vault.py                    # Knowledge Vault - local solution cache\n│   ├── genesis_state.py            # Phase 5\u002F6 hard gate state files\n│   ├── genesis_subcommands.py      # genesis check: CVE scan + CI action audit\n│   ├── pitfall_coverage_check.py   # Verifies PITFALLS.md mitigations exist in source\n│   ├── drift_detector.py           # Architecture drift detection vs ADR baseline\n│   ├── issue_miner.py              # GitHub Issue mining (GraphQL + REST)\n│   ├── feedback.py                 # Pitfall feedback recorder\n│   ├── env_probe.py                # Phase 0 environment detection\n│   └── eval_runner.py              # Trigger rate eval + schema validation\n├── tests\u002F                          # 372 unit tests\n├── evals\u002F\n│   ├── test_queries.json           # 40 trigger\u002Fno-trigger test cases (100% accuracy)\n│   └── README.md\n├── examples\u002F\n│   ├── typescript-cli\u002F\n│   └── python-cli\u002F\n├── references\u002F\n│   ├── architecture-patterns.md    # Boilerplate per language\u002Ftier + production defaults\n│   ├── mcp-strategy.md             # MCP tool strategy and fallback logic\n│   └── security-templates.md       # CI templates for secret scanning, SAST, quality gate\n├── .github\u002F\n│   ├── dependabot.yml\n│   └── workflows\u002F\n│       ├── ci.yml\n│       └── codeql.yml\n├── pyproject.toml\n├── CHANGELOG.md\n├── SECURITY.md\n└── CONTRIBUTING.md\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## Quality Shield\n\nFour CI jobs run on every push and pull request:\n\n| Job | What it gates | Secret required |\n|-----|--------------|-----------------|\n| `quality-gates` | 372 unit tests, evidence pack generation, mitigation enforcement, drift detection, scaffold smoke test, SKILL.md constraints | `GITHUB_TOKEN` (built-in) |\n| `secrets-scan` | Exposed credentials, API keys, tokens in every commit | none |\n| `sonarcloud` | Maintainability, Reliability, Security Hotspots; skips if SONAR_TOKEN absent | `SONAR_TOKEN` |\n| `security-scan` | Dependency CVEs (HIGH+) via Snyk; skips if SNYK_TOKEN absent | `SNYK_TOKEN` |\n\n**To activate optional jobs:** set repository Variables in Settings > Secrets and variables > Actions > Variables:\n- `SONAR_ENABLED` = `true` (then add `SONAR_TOKEN` as a Secret)\n- `SNYK_ENABLED` = `true` (then add `SNYK_TOKEN` as a Secret)\n\n> [!IMPORTANT]\n> After connecting SonarCloud, disable **Automatic Analysis** in SonarCloud project settings. Running both simultaneously causes the quality-gate job to fail.\n\n---\n\n## Roadmap\n\n| Priority | Feature | Status |\n|----------|---------|--------|\n| 1 | Demo GIF | Pending |\n| 2 | Go and Rust real-world example projects | In progress |\n| 3 | Benchmark report: Genesis vs plain Claude on real projects | Planned |\n| 4 | Interactive CLI with progress bars | Planned |\n| 5 | VS Code extension | Planned |\n\nCommunity contributions welcome - see [CONTRIBUTING.md](CONTRIBUTING.md).\n\n---\n\n## Community\n\n- **Share your output**: open a PR adding your `RESEARCH.md` and `PITFALLS.md` to `examples\u002F`\n- **Report missed pitfalls**: if something slipped past the research phase, open an issue\n- **Good first issues**: check the [`good first issue`](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Fissues?q=label%3A%22good+first+issue%22) label\n\n[Open an issue](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Fissues) | [Submit a PR](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Fpulls) | [Discussions](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Fdiscussions)\n\n---\n\n## Support this project\n\nGenesis Architect is free and open-source. If it saved you from a bad architecture decision or production incident:\n\n[![GitHub Sponsors](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor_on_GitHub-%23EA4AAA?style=for-the-badge&logo=github-sponsors)](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fmaioio)\n[![Buy Me a Coffee](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FBuy_Me_a_Coffee-%23FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https:\u002F\u002Fbuymeacoffee.com\u002Fmaioio)\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n> [!IMPORTANT]\n> Keep SKILL.md under 400 lines. No em dashes anywhere. All code, filenames, and comments in English.\n\n## License\n\n[MIT](LICENSE) - Maio Eshet\n\n---\n\n\u003Cdiv align=\"center\">\n\n**[Star this repo](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Fstargazers) if Genesis Architect saved you from a bad architecture decision. It helps others find it.**\n\n[Issues](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Fissues) · [Discussions](https:\u002F\u002Fgithub.com\u002Fmaioio\u002Fgenesis-architect\u002Fdiscussions) · [CHANGELOG](CHANGELOG.md)\n\n\u003C\u002Fdiv>\n","Genesis Architect 是一个专注于研究的项目脚手架工具，旨在为Claude Code生成项目基础架构前通过挖掘GitHub Issues来识别生产环境中的常见失败案例。其核心功能在于自动扫描并分析GitHub上的相关问题，识别出常见的错误、漏洞以及设计缺陷，并基于这些信息自动生成一个已经包含相应缓解措施的基础项目结构。该工具使用Python开发，具备良好的测试覆盖率和安全性，适用于希望避免重复他人已知错误的新项目启动场景，尤其适合那些寻求高效稳定起步的开发者或团队。","2026-06-11 04:02:53","CREATED_QUERY"]