{"id":40379486,"url":"https://github.com/galando/claude-dev-framework","last_synced_at":"2026-01-20T12:01:14.545Z","repository":{"id":331996689,"uuid":"1132429144","full_name":"galando/claude-dev-framework","owner":"galando","description":"Universal PIV methodology for Claude Code projects","archived":false,"fork":false,"pushed_at":"2026-01-15T16:47:29.000Z","size":1010,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-15T16:49:33.779Z","etag":null,"topics":["ai-assisted-development","anthropic","claude","claude-ai","claude-code","code-quality","context-engineering","developer-tools","nodejs","piv-methodology","python","react","software-development-workflow","spring-boot","template"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/galando.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://buymeacoffee.com/galando"]}},"created_at":"2026-01-11T23:53:38.000Z","updated_at":"2026-01-15T16:41:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/galando/claude-dev-framework","commit_stats":null,"previous_names":["galando/claude-piv-skeleton","galando/claude-dev-framework"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/galando/claude-dev-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galando%2Fclaude-dev-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galando%2Fclaude-dev-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galando%2Fclaude-dev-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galando%2Fclaude-dev-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/galando","download_url":"https://codeload.github.com/galando/claude-dev-framework/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/galando%2Fclaude-dev-framework/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28603295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T10:46:13.255Z","status":"ssl_error","status_checked_at":"2026-01-20T10:42:51.865Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assisted-development","anthropic","claude","claude-ai","claude-code","code-quality","context-engineering","developer-tools","nodejs","piv-methodology","python","react","software-development-workflow","spring-boot","template"],"created_at":"2026-01-20T12:00:38.733Z","updated_at":"2026-01-20T12:01:14.522Z","avatar_url":"https://github.com/galando.png","language":"Shell","readme":"# Claude Dev Framework\n\n[![Claude Dev Framework](https://img.shields.io/badge/Claude_Dev_Framework-AI_Development-blue?style=for-the-badge\u0026logo=anthropic)](https://github.com/galando/claude-dev-framework)\n[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)\n[![Visual Guide](https://img.shields.io/badge/🌐_Visual_Guide-Interactive_Methodology-467fd9?style=for-the-badge\u0026logo=github)](https://galando.github.io/claude-dev-framework/)\n[![Buy Me A Coffee](https://img.shields.io/badge/Buy_Me_A_Coffee-FFDD00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://buymeacoffee.com/galando)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/galando/claude-dev-framework)\n\n**Universal PIV (Prime-Implement-Validate) methodology for AI-assisted development with Claude Code.**\n\nA technology-agnostic, extensible framework with comprehensive documentation, rules, and templates to accelerate development while maintaining code quality.\n\n---\n\n## What is PIV?\n\n**PIV = Prime → Implement → Validate**\n\nA development methodology created by **Cole Medin** specifically for AI-assisted software development:\n\n- **Prime**: Load codebase context before making changes\n- **Implement**: Plan features, then execute (with strict TDD)\n- **Validate**: Automatic testing and verification\n\n[→ Interactive Visual Guide](https://galando.github.io/claude-dev-framework/) | [→ Full Methodology](.claude/reference/methodology/PIV-METHODOLOGY.md)\n\n---\n\n## Quick Start\n\n### One-Line Install\n\n```bash\ncurl -s https://raw.githubusercontent.com/galando/claude-dev-framework/main/scripts/piv.sh | bash\n```\n\n### Your First Feature (3 minutes)\n\n```bash\n# 1. Prime - Load context\n/piv_loop:prime\n\n# 2. Plan - Create implementation plan\n/piv_loop:plan-feature \"Add user authentication\"\n\n# 3. Execute - Implement with strict TDD\n/piv_loop:execute\n\n# 4. Validation runs automatically!\n```\n\n**TDD is enforced:** 🔴 RED (write failing test) → 🟢 GREEN (minimal code) → 🔵 REFACTOR (improve)\n\n### Updating\n\nRun the same command to update your installation:\n\n```bash\ncurl -s https://raw.githubusercontent.com/galando/claude-dev-framework/main/scripts/piv.sh | bash\n```\n\nThe script auto-detects if you need installation or update.\n\n**Pin to a specific version:**\n```bash\ncurl -s https://raw.githubusercontent.com/galando/claude-dev-framework/main/scripts/piv.sh | bash -s -- --version 1.1.0 --pin\n```\n\n**Preview changes without applying:**\n```bash\ncurl -s https://raw.githubusercontent.com/galando/claude-dev-framework/main/scripts/piv.sh | bash -s -- --dry-run\n```\n\n---\n\n## Key Features\n\n| Feature | Description |\n|---------|-------------|\n| 🚨 **Strict TDD** | Mandatory RED-GREEN-REFACTOR cycle. Zero exceptions. |\n| ⚡ **Skills System** | Auto-activating behaviors enforce best practices in real-time |\n| 🧠 **Adaptive Learning** | Framework gets smarter with every feature you build |\n| 🔧 **Technology Agnostic** | Works with Spring Boot, Node.js, Python, React, and more |\n| ⚙️ **Commands** | `/piv_loop:prime`, `/piv_loop:plan-feature`, `/piv_loop:execute`, `/validation:validate` |\n\n[→ See all features](docs/features/) | [→ Full commands list](docs/getting-started/02-quick-start.md#piv-commands-reference)\n\n---\n\n## Documentation\n\n| Guide | Description |\n|-------|-------------|\n| [Quick Start](docs/getting-started/02-quick-start.md) | Get started in 5 minutes |\n| [Installation](docs/getting-started/01-installation.md) | Detailed installation guide |\n| [Your First Feature](docs/getting-started/03-your-first-feature.md) | Step-by-step walkthrough |\n| [PIV Methodology](.claude/reference/methodology/PIV-METHODOLOGY.md) | Complete methodology guide |\n| [All Documentation](docs/README.md) | Full documentation index |\n\n---\n\n## Supported Technologies\n\n**Backend:** Spring Boot • Node.js/Express • Python/FastAPI\n**Frontend:** React + TypeScript\n**Database:** PostgreSQL\n**DevOps:** Docker\n\n[→ Add new technologies](docs/extending/01-adding-technologies.md)\n\n---\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n---\n\n## Repository Structure\n\n```\nclaude-dev-framework/\n├── .claude/                     # Claude Code configuration\n│   ├── CLAUDE.md                # Project instructions\n│   ├── agents/                  # Artifact directories\n│   ├── commands/                # PIV command definitions\n│   ├── reference/               # Complete guides\n│   ├── rules/                   # Coding rules\n│   └── skills/                  # Auto-activating behaviors\n├── .github/                     # GitHub configuration\n│   ├── workflows/               # CI/CD workflows\n│   └── ISSUE_TEMPLATE/          # Issue templates\n├── docs/                        # Comprehensive documentation\n│   ├── getting-started/         # Getting started guides\n│   ├── features/                # Feature documentation\n│   ├── extending/               # Extension guides\n│   ├── methodology/             # Methodology deep dives\n│   └── index.html               # GitHub Pages site\n├── scripts/                     # Utility scripts\n│   └── install/                 # Installer scripts\n├── technologies/                # Technology templates\n│   ├── backend/                 # Backend frameworks\n│   ├── frontend/                # Frontend frameworks\n│   ├── database/                # Databases\n│   └── devops/                  # DevOps tools\n├── CHANGELOG.md                 # Changelog\n├── CONTRIBUTING.md              # Contributing guidelines\n├── LICENSE                      # MIT License\n└── README.md                    # This file\n```\n\n---\n\n## Origins\n\n**PIV Methodology created by [Cole Medin (coleam00)](https://github.com/coleam00)**\n\nBased on [context-engineering-intro](https://github.com/coleam00/context-engineering-intro) and [habit-tracker](https://github.com/coleam00/habit-tracker).\n\n---\n\n## License\n\nMIT License - see [LICENSE](LICENSE)\n\n---\n\n**Made with ❤️ for the Claude Code community**\n","funding_links":["https://buymeacoffee.com/galando"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgalando%2Fclaude-dev-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgalando%2Fclaude-dev-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgalando%2Fclaude-dev-framework/lists"}