@aicgen/aicgen 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lahiru Pathirage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,199 @@
+<p align="center">
+  <img src="assets/logo.svg" width="1000" alt="aicgen logo" />
+</p>
+
+<p align="center">
+  <em>Configuration generator for AI coding assistants</em>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-1.0--beta-cyan" alt="Version" />
+  <img src="https://img.shields.io/badge/license-MIT-purple" alt="License" />
+  <img src="https://img.shields.io/badge/bun-%3E%3D1.0.0-cyan" alt="Bun" />
+  <img src="https://img.shields.io/github/actions/workflow/status/aicgen/aicgen/test.yml?branch=main&label=tests" alt="Tests" />
+  <img src="https://img.shields.io/badge/coverage-94%25-brightgreen" alt="Coverage" />
+</p>
+
+---
+
+**aicgen** makes your project AI-ready in seconds. Generate tailored instruction files for your AI coding assistant with an interactive CLI wizard.
+
+## ✨ Features
+
+- **🎯 Multi-Assistant Support** - Claude Code, GitHub Copilot, Gemini, Antigravity, Codex
+- **📚 82+ Guidelines** - Organized into 12 categories (Language, Architecture, Testing, Security, etc.)
+- **🎨 Interactive CLI** - Professional wizard with smart defaults and back navigation
+- **⚡ Hooks & Sub-Agents** - Auto-generates Claude Code hooks and verification agents
+- **🏗️ Architecture Aware** - Supports Microservices, Modular Monoliths, Hexagonal, and more
+- **📦 Zero External Dependencies** - All guideline data is embedded in the binary
+
+## 🚀 Quick Start
+
+Navigate to your project and run:
+
+```bash
+aicgen init
+```
+
+The CLI will:
+1.  Detect your project language and structure
+2.  Guide you through assistant, architecture, and detail level selection
+3.  Let you customize which guidelines to include
+4.  Generate the appropriate config files (`.claude/`, `.github/`, `.agent/`, etc.)
+
+---
+
+## 📦 Installation
+
+### From npm (Easiest)
+
+```bash
+# Install globally
+npm install -g @aicgen/aicgen
+
+# Or use with npx (no installation)
+npx @aicgen/aicgen init
+```
+
+### From Binary (Standalone)
+
+Download the latest binary for your platform from the [releases page](https://github.com/aicgen/aicgen/releases):
+
+- **Windows**: `aicgen.exe`
+- **Linux**: `aicgen-linux`
+- **macOS**: `aicgen-macos`
+
+```bash
+# Windows
+.\aicgen.exe init
+```
+
+### From Source
+
+```bash
+git clone https://github.com/aicgen/aicgen.git
+cd aicgen
+bun install
+bun run build:binary
+bun run start init
+```
+
+---
+
+## 📚 Guideline System
+
+aicgen uses a **modular guideline architecture** with **82+ guidelines** organized into **12 categories**.
+
+```bash
+# View guideline statistics
+aicgen stats
+```
+
+**Categories:**
+- **Language** - TypeScript, Python, Go, Rust, Java, C#, Ruby, JavaScript
+- **Architecture** - Layered, Modular Monolith, Microservices, Event-Driven, Hexagonal
+- **DevOps** - CI/CD, Docker, Observability (Log formats, Metrics)
+- **Best Practices** - SOLID, DRY, Clean Code principles
+- And more...
+
+## 📁 Generated Outputs
+
+### For Claude Code
+```text
+CLAUDE.md                      # Master instructions (project root)
+.claude/
+├── settings.json              # Hooks & permissions
+├── guidelines/                # Modular guidelines
+│   ├── language.md
+│   ├── architecture.md
+│   └── ...
+└── agents/                    # Sub-agents
+    └── guideline-checker.md
+```
+
+### For GitHub Copilot
+```text
+.github/
+├── copilot-instructions.md    # Master instructions
+└── instructions/              # Topic-specific files
+```
+
+### For Gemini / Antigravity
+```text
+.gemini/                       # or .agent/
+└── instructions.md            # Consolidated system prompt
+```
+
+---
+
+## 🗺️ Roadmap
+
+### ✅ Completed
+
+- [x] Interactive CLI wizard with back navigation
+- [x] Multi-assistant support (Claude Code, Copilot, Gemini, Antigravity, Codex)
+- [x] 82+ guidelines across 12 categories
+- [x] Architecture-aware configuration (Layered, Modular Monolith, Microservices, etc.)
+- [x] Auto-generated hooks and sub-agents for Claude Code
+- [x] Custom guideline management (add/remove)
+- [x] GitHub-based guideline updates
+
+### 🚧 Future Enhancements
+
+- [ ] Custom validation hooks
+- [ ] Guideline versioning and diffing
+- [ ] Project-specific guideline templates
+
+## 🛠️ Development
+
+### Running Tests
+
+The project includes a comprehensive test suite with 60+ tests covering all core functionality:
+
+```bash
+# Run all tests
+bun test
+
+# Run tests with coverage report
+bun test --coverage
+
+# Run tests in watch mode
+bun test --watch
+```
+
+### Test Coverage
+
+Current test coverage: **94%** (93.44% function coverage, 94.52% line coverage)
+
+**Test Suite Includes:**
+- ✅ GuidelineLoader tests (filtering, level selection, architecture handling)
+- ✅ Tarball extraction tests (CONFIG-based prefix validation)
+- ✅ AssistantFileWriter tests (all 5 assistants - Claude Code, Copilot, Gemini, Antigravity, Codex)
+- ✅ File generation and path handling (cross-platform compatibility)
+- ✅ Content validation and metadata inclusion
+
+Tests are automatically excluded from builds via `tsconfig.json`.
+
+### Project Structure
+
+```
+src/
+├── __tests__/              # Test suite
+│   └── services/
+│       ├── guideline-loader.test.ts
+│       ├── tarball-extraction.test.ts
+│       └── assistant-file-writer.test.ts
+├── commands/               # CLI commands (init, update, quick-add)
+├── services/               # Core business logic
+└── config.ts              # Configuration management
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## 📄 License
+
+MIT © 2025

package/assets/icon.svg

@@ -0,0 +1,34 @@
+<svg width="300" height="150" viewBox="0 0 300 150" fill="none" xmlns="http://www.w3.org/2000/svg">
+    <defs>
+        <linearGradient id="flowGradient" x1="50" y1="75" x2="160" y2="75" gradientUnits="userSpaceOnUse">
+            <stop offset="0%" stop-color="#06b6d4" /> <stop offset="100%" stop-color="#8b5cf6" /> </linearGradient>
+        <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+            <feGaussianBlur stdDeviation="2" result="coloredBlur"/>
+            <feMerge>
+                <feMergeNode in="coloredBlur"/>
+                <feMergeNode in="SourceGraphic"/>
+            </feMerge>
+        </filter>
+    </defs>
+
+    <rect width="700" height="150" fill="#0f172a" rx="8" />
+
+    <g transform="translate(40, 35)">
+        <rect x="160" y="0" width="60" height="80" rx="6" fill="#1e1b4b" stroke="#8b5cf6" stroke-width="2"/>
+        <path d="M200 0 L220 20 L220 6 A 6 6 0 0 0 214 0 Z" fill="#8b5cf6" opacity="0.5"/>
+        <rect x="170" y="20" width="30" height="4" rx="2" fill="#8b5cf6" opacity="0.6"/>
+        <rect x="170" y="32" width="40" height="4" rx="2" fill="#8b5cf6" opacity="0.6"/>
+        <rect x="170" y="44" width="35" height="4" rx="2" fill="#8b5cf6" opacity="0.6"/>
+        <circle cx="210" cy="70" r="3" fill="#10b981" filter="url(#glow)" />
+
+        <circle cx="20" cy="15" r="8" fill="#06b6d4" filter="url(#glow)" />
+        <circle cx="20" cy="40" r="8" fill="#06b6d4" filter="url(#glow)" />
+        <circle cx="20" cy="65" r="8" fill="#06b6d4" filter="url(#glow)" />
+
+        <path d="M28 15 C 60 15, 100 15, 160 30" stroke="url(#flowGradient)" stroke-width="3" fill="none" stroke-linecap="round"/>
+        <path d="M28 40 C 60 40, 100 40, 160 40" stroke="url(#flowGradient)" stroke-width="3" fill="none" stroke-linecap="round"/>
+        <path d="M28 65 C 60 65, 100 65, 160 50" stroke="url(#flowGradient)" stroke-width="3" fill="none" stroke-linecap="round"/>
+    </g>
+
+
+</svg>

package/assets/logo.svg

@@ -0,0 +1,41 @@
+<svg width="700" height="150" viewBox="0 0 700 150" fill="none" xmlns="http://www.w3.org/2000/svg">
+    <defs>
+        <linearGradient id="flowGradient" x1="50" y1="75" x2="160" y2="75" gradientUnits="userSpaceOnUse">
+            <stop offset="0%" stop-color="#06b6d4" /> <stop offset="100%" stop-color="#8b5cf6" /> </linearGradient>
+        <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+            <feGaussianBlur stdDeviation="2" result="coloredBlur"/>
+            <feMerge>
+                <feMergeNode in="coloredBlur"/>
+                <feMergeNode in="SourceGraphic"/>
+            </feMerge>
+        </filter>
+    </defs>
+
+    <rect width="700" height="150" fill="#0f172a" rx="8" />
+
+    <g transform="translate(40, 35)">
+        <rect x="160" y="0" width="60" height="80" rx="6" fill="#1e1b4b" stroke="#8b5cf6" stroke-width="2"/>
+        <path d="M200 0 L220 20 L220 6 A 6 6 0 0 0 214 0 Z" fill="#8b5cf6" opacity="0.5"/>
+        <rect x="170" y="20" width="30" height="4" rx="2" fill="#8b5cf6" opacity="0.6"/>
+        <rect x="170" y="32" width="40" height="4" rx="2" fill="#8b5cf6" opacity="0.6"/>
+        <rect x="170" y="44" width="35" height="4" rx="2" fill="#8b5cf6" opacity="0.6"/>
+        <circle cx="210" cy="70" r="3" fill="#10b981" filter="url(#glow)" />
+
+        <circle cx="20" cy="15" r="8" fill="#06b6d4" filter="url(#glow)" />
+        <circle cx="20" cy="40" r="8" fill="#06b6d4" filter="url(#glow)" />
+        <circle cx="20" cy="65" r="8" fill="#06b6d4" filter="url(#glow)" />
+
+        <path d="M28 15 C 60 15, 100 15, 160 30" stroke="url(#flowGradient)" stroke-width="3" fill="none" stroke-linecap="round"/>
+        <path d="M28 40 C 60 40, 100 40, 160 40" stroke="url(#flowGradient)" stroke-width="3" fill="none" stroke-linecap="round"/>
+        <path d="M28 65 C 60 65, 100 65, 160 50" stroke="url(#flowGradient)" stroke-width="3" fill="none" stroke-linecap="round"/>
+    </g>
+
+    <g transform="translate(290, 85)" text-anchor="start">
+        <text x="0" y="0" font-family="'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-weight="bold" font-size="32" fill="white" letter-spacing="1">
+            AI Config Generator
+        </text>
+        <text x="0" y="24" font-family="'Segoe UI', Roboto, Helvetica, Arial, sans-serif" font-weight="400" font-size="14" fill="#94a3b8" letter-spacing="1.2">
+            for better coding
+        </text>
+    </g>
+</svg>