@haposoft/cafekit 0.8.16 → 0.9.0

package/src/antigravity/workflows/docs-init.md

@@ -1,432 +0,0 @@
----
-description: Initialize comprehensive documentation for the project. Use when setting up docs for the first time or creating documentation skeleton from existing codebase.
----
-
-# /docs-init - Initialize Project Documentation
-
-## Overview
-
-This workflow creates comprehensive documentation structure for your project:
-- Generates 7 core documentation files
-- Creates project context file (.agent/rules/AGENTS.md)
-- Uses repomix for codebase analysis
-
-## ⚠️ IMPORTANT: Execute Immediately
-
-**DO NOT create an implementation plan.** This workflow should be executed directly without planning mode.
-- Run all steps sequentially
-- Create files immediately as described
-- No approval needed between steps
-
----
-
-## Step 1: Check Prerequisites
-
-**Check if docs/ already exists:**
-```bash
-ls -la docs/ 2>/dev/null && echo "EXISTS" || echo "NOT_FOUND"
-```
-
-**If docs/ exists:**
-- Ask user: "docs/ already exists. Overwrite / Merge / Skip?"
-- Default: "Merge" (preserve existing, add missing)
-
----
-
-## Step 2: Install Repomix
-
-**Check if repomix is installed:**
-```bash
-which repomix 2>/dev/null || npm list -g repomix 2>/dev/null
-```
-
-**If repomix not found:**
-- Detect package manager:
-  ```bash
-  test -f pnpm-lock.yaml && PM="pnpm"
-  test -f yarn.lock && PM="yarn"
-  test -f bun.lockb && PM="bun"
-  PM="${PM:-npm}"
-  ```
-
-// turbo
-- Run `$PM install -g repomix`
-- Verify: `which repomix`
-
----
-
-## Step 3: Run Repomix Analysis
-
-// turbo
-```bash
-repomix
-ls -la ./repomix-output.xml
-```
-
----
-
-## Step 4: Auto-Detect Project Information
-
-**Detect Package Manager & Tech Stack:**
-```bash
-test -f pnpm-lock.yaml && echo "PNPM"
-test -f yarn.lock && echo "YARN"
-test -f package-lock.json && echo "NPM"
-test -f bun.lockb && echo "BUN"
-test -f requirements.txt && echo "PIP"
-test -f poetry.lock && echo "POETRY"
-test -f go.mod && echo "GO"
-test -f Cargo.toml && echo "CARGO"
-```
-
-**Read Config Files:**
-- Read `package.json` for name, version, scripts, dependencies
-- Read `pyproject.toml` if Python project
-- Read `go.mod` if Go project
-- Read `README.md` for description
-
-**Extract:**
-- Project name, version, description
-- Tech stack with versions
-- Available scripts/commands
-- Key dependencies
-
----
-
-## Step 5: Detect Project Structure
-
-**Get directory structure:**
-```bash
-find . -maxdepth 3 -type d ! -path './node_modules/*' ! -path './.git/*' ! -path './.*' 2>/dev/null | sort | head -40
-```
-
-**Detect Platforms & Tools:**
-- **Deployment**: `vercel.json`, `netlify.toml`, `Dockerfile`, `fly.toml`, `.github/workflows`
-- **Database**: `prisma/schema.prisma`, `drizzle.config.ts`
-- **API**: `src/app/api`, `src/routes`, `pages/api`
-- **Testing**: Check package.json for `vitest`, `jest`, `playwright`, `cypress`
-- **UI**: Check for `tailwind`, `@base-ui`, `shadcn`, etc.
-
----
-
-## Step 6: Create docs/ Directory
-
-// turbo
-```bash
-mkdir -p docs/
-```
-
----
-
-## Step 7: Generate Documentation Files
-
-### 7.1 Create docs/codebase-summary.md
-
-```markdown
-# Codebase Summary
-
-> Auto-generated project overview
-
-## Project Info
-| Property | Value |
-|----------|-------|
-| **Name** | {from package.json} |
-| **Version** | {from package.json} |
-| **Type** | {detected} |
-| **Package Manager** | {detected} |
-
-## Statistics
-| Metric | Value |
-|--------|-------|
-| Files | {from repomix} |
-| Tokens | {from repomix} |
-| Generated | {timestamp} |
-
-## Tech Stack
-| Layer | Technology |
-|-------|------------|
-| Framework | {detected with version} |
-| Language | {detected} |
-| Styling | {detected} |
-| UI Library | {detected} |
-| Database | {if detected} |
-| Testing | {if detected} |
-
-## Project Structure
-```
-{directory tree from analysis}
-```
-
-## Key Directories
-| Directory | Purpose |
-|-----------|---------|
-| {detected} | {inferred purpose} |
-```
-
-### 7.2 Create docs/project-overview-pdr.md
-
-```markdown
-# Project Overview (PDR)
-
-## Identity
-- **Name:** {name}
-- **Type:** {type}
-- **Status:** Active
-
-## Description
-{from package.json description or README}
-
-## Features
-{extract from codebase}
-
-## Roadmap
-- [ ] Current sprint
-- [ ] Next milestones
-```
-
-### 7.3 Create docs/code-standards.md
-
-```markdown
-# Code Standards
-
-## Stack
-- Language: {detected}
-- Framework: {detected}
-- Linting: {detected}
-
-## Conventions
-{inferred from codebase patterns}
-
-## Patterns
-{common patterns detected}
-
-## File Organization
-{detected structure}
-```
-
-### 7.4 Create docs/system-architecture.md
-
-```markdown
-# System Architecture
-
-## Overview
-{architecture type: monolith, microservices, serverless, etc.}
-
-## Components
-| Component | Tech | Purpose |
-|-----------|------|---------|
-| Frontend | {detected} | UI layer |
-| Backend | {detected} | API layer |
-| Database | {detected} | Data persistence |
-
-## Data Flow
-{simple description}
-
-## API Structure
-{if detected}
-
-## Database Schema
-{if detected}
-```
-
-### 7.5 Create docs/design-guidelines.md
-
-```markdown
-# Design Guidelines
-
-## System
-- CSS Framework: {Tailwind/Styled/etc}
-- UI Library: {detected}
-- Icons: {detected}
-
-## Patterns
-{detected patterns}
-
-## Responsive
-{breakpoints if Tailwind}
-
-## Theme
-{dark/light mode setup}
-```
-
-### 7.6 Create docs/deployment-guide.md
-
-```markdown
-# Deployment Guide
-
-## Platform
-{detected platform}
-
-## Quick Deploy
-```bash
-{platform-specific commands}
-```
-
-## Environment Variables
-{from .env.example if exists}
-
-## Available Commands
-| Command | Purpose |
-|---------|---------|
-| {from package.json} | {description} |
-```
-
-### 7.7 Create docs/project-roadmap.md
-
-```markdown
-# Project Roadmap
-
-## Current
-{detected state}
-
-## Short Term (30 days)
-- [ ] Tasks
-
-## Medium Term (90 days)
-- [ ] Enhancements
-
-## Long Term (6 months)
-- [ ] Scale
-
-## Technical Debt
-{detected issues}
-```
-
----
-
-## Step 8: Create .agent/rules/AGENTS.md (Optional)
-
-**Check if .agent/rules/ exists:**
-```bash
-test -d .agent/rules && echo "EXISTS" || echo "NOT_FOUND"
-```
-
-**If not exists, create it:**
-// turbo
-```bash
-mkdir -p .agent/rules
-```
-
-**Create .agent/rules/AGENTS.md:**
-
-```markdown
----
-activation: always_on
----
-
-# {Project Name}
-
-> Project-specific context for AI agents (Antigravity, Claude Code, etc.). See `.agent/` for workflows and skills.
-
----
-
-## Project Overview
-
-{description from package.json or README}
-
----
-
-## Tech Stack
-
-| Layer | Technology |
-|-------|------------|
-| {detected} | {with versions} |
-
----
-
-## Key Directories
-
-| Directory | Purpose |
-|-----------|---------|
-| {detected} | {description} |
-
----
-
-## Quick Commands
-
-| Task | Command |
-|------|---------|
-| {from package.json scripts} | `{pm} run {script}` |
-
----
-
-## Project Docs (On-demand)
-
-| Doc | Purpose | Load when |
-|-----|---------|-----------|
-| `docs/codebase-summary.md` | Project overview | "summary", "overview" |
-| `docs/project-overview-pdr.md` | Product requirements | "requirements", "pdr" |
-| `docs/code-standards.md` | Coding conventions | "standards", "conventions" |
-| `docs/system-architecture.md` | Architecture | "architecture", "design" |
-| `docs/design-guidelines.md` | UI/UX standards | "design", "ui", "ux" |
-| `docs/deployment-guide.md` | Deployment | "deploy", "production" |
-| `docs/project-roadmap.md` | Roadmap | "roadmap", "future" |
-
----
-
-## Agent Workflows
-
-Available workflows in `.agent/workflows/`:
-- `/docs-init` - Initialize documentation
-- `/docs-update` - Update documentation
-
----
-
-**Last Updated:** {timestamp}
-```
-
-**Note:**
-- File `.agent/rules/AGENTS.md` với `activation: always_on` sẽ được **always active** trong Antigravity
-- Đặt trong `.agent/rules/` để Antigravity tự động nhận diện và load
-- Có thể đồng thờI tạo symlink `AGENTS.md` ở root để dùng cho Claude Code
-
----
-
-## Step 9: Generate Report
-
-**Output success message:**
-
-```
-✅ Documentation initialized!
-
-📊 Detected:
-   - Project: {name}
-   - Type: {type}
-   - Stack: {summary}
-   - Files: {count} | Tokens: {count}
-
-📁 Generated (docs/):
-   ✓ codebase-summary.md
-   ✓ project-overview-pdr.md
-   ✓ code-standards.md
-   ✓ system-architecture.md
-   ✓ design-guidelines.md
-   ✓ deployment-guide.md
-   ✓ project-roadmap.md
-
-📝 Also created:
-   ✓ repomix-output.xml (AI context)
-   ✓ .agent/rules/AGENTS.md (always-active project context)
-
-🚀 Next: Run `/docs-update` after code changes
-```
-
----
-
-## Error Handling
-
-| Scenario | Action |
-|----------|--------|
-| repomix not found | Warn, continue with manual analysis |
-| No package.json | Ask user for project type |
-| docs/ exists | Ask: Overwrite/Merge/Skip |
-| Permission denied | Report path, suggest fix |
-
----
-
-## Notes
-
-- Always use detected values, never placeholders
-- Include versions: "Next.js 14.1.0" not "Next.js"
-- repomix-output.xml helps AI understand full context
-- 7 docs files = comprehensive coverage

package/src/antigravity/workflows/docs-update.md

@@ -1,245 +0,0 @@
----
-description: Update existing documentation to match current codebase. Use when code has changed and docs are out of sync, or after adding new features.
----
-
-# /docs-update - Update Project Documentation
-
-## Overview
-
-This workflow updates all documentation to reflect the current state of the codebase:
-- Re-analyzes project structure
-- Updates all 7 documentation files
-- Syncs AGENTS.md with latest changes
-- Creates backup before updating
-
-## ⚠️ IMPORTANT: Execute Immediately
-
-**DO NOT create an implementation plan.** This workflow should be executed directly without planning mode.
-- Run all steps sequentially
-- Update files immediately as described
-- No approval needed between steps
-
----
-
-## Step 1: Verify Prerequisites
-
-**Check if docs/ exists:**
-```bash
-ls docs/ 2>/dev/null || echo "ERROR: Run '/docs-init' first"
-```
-
-**If docs/ not found:**
-- Stop and prompt: "❌ docs/ not found. Run `/docs-init` first to create documentation."
-
----
-
-## Step 2: Create Backup
-
-// turbo
-```bash
-cp -r docs docs.backup.$(date +%Y%m%d_%H%M%S)
-echo "Backup created: docs.backup.{timestamp}"
-```
-
----
-
-## Step 3: Ensure Repomix Available
-
-**Check if repomix is installed:**
-```bash
-which repomix 2>/dev/null || npm list -g repomix 2>/dev/null
-```
-
-**If repomix not found:**
-- Detect package manager:
-  ```bash
-  test -f pnpm-lock.yaml && PM="pnpm"
-  test -f yarn.lock && PM="yarn"
-  test -f bun.lockb && PM="bun"
-  PM="${PM:-npm}"
-  ```
-
-// turbo
-- Run `$PM install -g repomix`
-
----
-
-## Step 4: Re-analyze Codebase
-
-// turbo
-```bash
-repomix
-ls -la ./repomix-output.xml
-```
-
-**Detect recent changes:**
-```bash
-git diff --stat HEAD~5..HEAD 2>/dev/null || echo "No git history"
-```
-
----
-
-## Step 5: Read Current Documentation
-
-Read all existing docs to understand what needs updating:
-- `docs/codebase-summary.md`
-- `docs/project-overview-pdr.md`
-- `docs/code-standards.md`
-- `docs/system-architecture.md`
-- `docs/design-guidelines.md`
-- `docs/deployment-guide.md`
-- `docs/project-roadmap.md`
-- `.agent/rules/AGENTS.md` (if exists)
-
----
-
-## Step 6: Detect Updated Project Info
-
-**Re-read config files:**
-- `package.json` - check for new scripts, dependencies, version changes
-- `pyproject.toml`, `go.mod`, etc. - based on project type
-- Check for new directories or removed ones
-
-**Detect changes:**
-- New frameworks/libraries added
-- Version updates
-- New scripts
-- Structure changes
-- New deployment configs
-- New database schemas
-
----
-
-## Step 7: Update Documentation Files
-
-### 7.1 Update docs/codebase-summary.md
-
-**Refresh:**
-- File count and token count from repomix
-- Tech stack versions (from package.json)
-- Directory structure if changed
-- Timestamp
-
-### 7.2 Update docs/project-overview-pdr.md
-
-**Add:**
-- New features detected in codebase
-- Updated description if changed
-- Any new capabilities
-
-### 7.3 Update docs/code-standards.md
-
-**Sync:**
-- New patterns detected in code
-- Updated conventions
-- New linting rules if config changed
-
-### 7.4 Update docs/system-architecture.md
-
-**Update:**
-- New components or services
-- Changed data flows
-- New API endpoints
-- Database schema changes
-
-### 7.5 Update docs/design-guidelines.md
-
-**Refresh:**
-- New UI components
-- Updated styling patterns
-- Theme changes
-
-### 7.6 Update docs/deployment-guide.md
-
-**Update:**
-- New environment variables
-- Changed deployment commands
-- Platform updates
-
-### 7.7 Update docs/project-roadmap.md
-
-**Progress tracking:**
-- Mark completed items
-- Add new tasks based on TODOs found
-- Update technical debt section
-
----
-
-## Step 8: Update .agent/rules/AGENTS.md
-
-**Check if .agent/rules/AGENTS.md exists:**
-```bash
-test -f .agent/rules/AGENTS.md && cat .agent/rules/AGENTS.md || echo "NOT_FOUND"
-```
-
-**If exists - Update sections:**
-- **Tech Stack** - Update versions, add new dependencies
-- **Key Directories** - Add new directories
-- **Quick Commands** - Sync with package.json scripts
-- **Last Updated** - Refresh timestamp
-
-**If not exists - Create new:**
-- Use same template as in `/docs-init`
-- Or skip if user không muốn tạo
-
-**Note:** `.agent/rules/AGENTS.md` với `activation: always_on` sẽ luôn active trong Antigravity.
-
----
-
-## Step 9: Clean Up
-
-// turbo
-**Remove old repomix if needed:**
-```bash
-# Keep repomix-output.xml for AI context
-ls -la repomix-output.xml
-```
-
----
-
-## Step 10: Generate Report
-
-**Output success message:**
-
-```
-🔄 Documentation updated!
-
-💾 Backup: docs.backup.{timestamp}/
-
-📊 Changes:
-   - Files: {old_count} → {new_count}
-   - Tokens: {old_tokens} → {new_tokens}
-
-📝 Updated:
-   ✓ codebase-summary.md
-   ✓ project-overview-pdr.md
-   ✓ code-standards.md
-   ✓ system-architecture.md
-   ✓ design-guidelines.md
-   ✓ deployment-guide.md
-   ✓ project-roadmap.md
-   ✓ .agent/rules/AGENTS.md (if exists)
-
-💡 Review docs/ for any manual adjustments needed
-```
-
----
-
-## Error Handling
-
-| Scenario | Action |
-|----------|--------|
-| docs/ not found | Prompt to run `/docs-init` |
-| repomix fails | Continue with manual analysis |
-| Permission denied | Report path, suggest sudo/fix |
-| Conflicts detected | Ask user which version to keep |
-
----
-
-## Notes
-
-- Always create backup before updating
-- Merge existing content with new analysis
-- Preserve manual edits when possible
-- Update timestamp on all modified files
-- Keep repomix-output.xml for AI context