Features

Detailed introduction to all features of AI Instruction Kits.

🧩 NEW! Modular Instruction System

Overview

Revolutionary feature released in July 2025 that dynamically generates instructions based on project requirements.

MODULE_COMPOSER

Analyzes tasks and automatically generates customized instructions by combining optimal modules.

Key Features:

🚀 Pre-generated Presets (Fast & Recommended)

Pre-generated instructions that can be used immediately with 0-second response time.

Available Presets (8 types)

  1. web_api_production: Production Web API Development
    • RESTful API design, security implementation, documentation generation
    • Path: instructions/en/presets/web_api_production.md
  2. cli_tool_basic: CLI Tool Development
    • Command line parsing, error handling, distribution preparation
    • Path: instructions/en/presets/cli_tool_basic.md
  3. data_analyst: Data Analysis Tasks
    • Data preprocessing, statistical analysis, visualization, report creation
    • Path: instructions/en/presets/data_analyst.md
  4. technical_writer: Technical Documentation
    • API documentation, user guides, technical blogs, README creation
    • Path: instructions/en/presets/technical_writer.md
  5. academic_researcher: Academic Research Support
    • Literature review, paper writing, citation management, research planning
    • Path: instructions/en/presets/academic_researcher.md
  6. business_consultant: Business Consulting
    • Market analysis, strategy planning, presentation creation, ROI calculation
    • Path: instructions/en/presets/business_consultant.md
  7. project_manager: Project Management
    • Task management, resource allocation, progress tracking, risk management
    • Path: instructions/en/presets/project_manager.md
  8. startup_advisor: Startup Support
    • Business model, pitch deck, fundraising, MVP development
    • Path: instructions/en/presets/startup_advisor.md

Benefits of Presets

Expertise Modules (5 types)

  1. software_engineering: Latest software engineering compliant with SWEBOK v4.0
  2. legal_engineering: Legal engineering and regulatory technology expertise
  3. machine_learning: ML/AI design, implementation, and operations
  4. parallel_distributed: Parallel and distributed system expertise
  5. data_space: Data space construction including GAIA-X, IDS

Module Types

Usage Examples

# Writing academic papers
claude "Write a research paper"
# → MODULE_COMPOSER selects academic_researcher preset
# → Also adds citation management, methodology design, statistical analysis modules

# Data analysis
claude "Analyze sales data"
# → data_analyst preset is automatically selected
# → Combines visualization, statistical processing, report creation modules

# Specialized tasks
claude "Design a distributed system"
# → parallel_distributed expertise module is selected
# → Design based on 2024-2025 latest technology trends

📚 Instruction Categories

1. System Management (system)

Basic instructions to control AI behavior

2. General Tasks

General-purpose instructions for daily tasks

3. Coding

Instructions specialized for programming tasks

4. Writing

For document and content creation

5. Analysis

For data analysis and research tasks

6. Creative

Support for creative tasks

7. Agent-based

Instructions to behave as specific experts

🔧 Core Features

Checkpoint Management (Extended Version)

Detailed tracking of work progress and instruction usage history

# Task start
scripts/checkpoint.sh start "New feature implementation" 5
📌 Task ID: TASK-123456-abc123

# Track instruction usage (new feature)
scripts/checkpoint.sh instruction-start "instructions/en/presets/web_api_production.md" "API development" TASK-123456-abc123
scripts/checkpoint.sh instruction-complete "instructions/en/presets/web_api_production.md" "3 endpoints implemented" TASK-123456-abc123

# AI-friendly concise output mode (new feature)
scripts/checkpoint.sh ai pending
scripts/checkpoint.sh ai progress TASK-123456-abc123 2 5 "Implementing" "Creating tests"

# Statistics display (new feature)
scripts/checkpoint.sh stats
scripts/checkpoint.sh history

Claude Code Custom Commands (New Feature)

Efficiency features for Claude Code users:

Command Description Example
/checkpoint Checkpoint management /checkpoint start "New feature implementation" 5
/commit-and-report Commit & Issue report /commit-and-report "Bug fix complete"
/commit-safe Clean commit (no AI signature) /commit-safe "Documentation update"
/reload-instructions Reload instructions /reload-instructions
/github-issues 🆕 Check GitHub issues and organize tasks /github-issues
/reload-and-reset 🆕 Reset AI system and reload instructions /reload-and-reset

Integration Modes

Choose based on project needs

Mode Benefits Use Cases
Copy • No Git
• Fastest setup
• Offline support		 Small projects
Non-Git environments
Clone • Full control
• Custom modifications
• History management		 Large customizations
Custom instruction development
Submodule • Easy updates
• Version control
• Multi-project support		 Team development
Long-term projects

Custom URL Support

Use instructions from your own repository

# Corporate internal repository
--url https://gitlab.company.com/ai-team/instructions.git

# Personal fork
--url https://github.com/yourname/custom-instructions.git

# Private repository (requires authentication)
--url git@github.com:org/private-instructions.git

🎯 Advanced Usage

1. Creating Custom Instructions

# Custom Instruction Template
## Purpose
Clearly describe the purpose of this instruction

## Prerequisites
- Required knowledge
- Environment requirements
- Dependencies

## Specific Instructions
1. Detailed step 1
2. Detailed step 2
3. ...

## Expected Outcomes
- Deliverable 1
- Deliverable 2

---
## License Information
- **License**: [License name]
- **Author**: [Name]
- **Date**: [Date]

2. PROJECT.md Customization

Describe project-specific settings in detail:

## Project-specific Additional Instructions

### Architecture
- Microservices architecture
- API Gateway: Kong
- Message Queue: RabbitMQ

### Development Standards
- Commit messages: Conventional Commits
- Branch strategy: Git Flow
- Code review: Required (2+ reviewers)

### Security
- Authentication: OAuth 2.0
- Data encryption: AES-256
- Secret management: HashiCorp Vault

3. Pre-customizing Templates

# Edit templates
vi templates/en/PROJECT_TEMPLATE.md

# Add common settings applied to all new projects
- CI/CD configuration
- Standard lint rules
- Common test frameworks

🔒 Security Features

Private Repository Support

Securely retrieve instructions from organization-specific private repositories.

Implementation

# Example of internal repository
bash setup-project.sh --url https://github.com/company/private-ai-instructions.git

SSH Authentication Support

Supports secure authentication using SSH keys.

Implementation

# Using SSH format URL
bash setup-project.sh --url git@github.com:company/private-instructions.git --submodule

Access Token Support

Supports authentication using personal access tokens from GitHub/GitLab.

Implementation

# Embedding token in URL
bash setup-project.sh --url https://YOUR_TOKEN@github.com/company/repo.git

# Using environment variable (more secure)
export GIT_TOKEN=your_personal_access_token
bash setup-project.sh --url https://${GIT_TOKEN}@github.com/company/repo.git

Internal Network Support

Supports Git servers inside organizations not exposed to the internet.

Implementation

# Example internal GitLab server
bash setup-project.sh --url https://gitlab.company.local/team/ai-instructions.git

# Example internal Gitea server
bash setup-project.sh --url http://git.internal:3000/dev/instructions.git

📦 Version Management

Version Pinning

Pin the version of instructions used in your project to prevent unexpected changes.

Implementation with Submodules

# Pin to specific commit
cd instructions/ai_instruction_kits
git checkout v1.2.3  # or specific commit hash
cd ../..
git add instructions/ai_instruction_kits
git commit -m "Pin instructions to v1.2.3"

Update Control

Manage instruction updates systematically and apply after testing.

Update Process

# Check latest version (without actually updating)
cd instructions/ai_instruction_kits
git fetch
git log HEAD..origin/main --oneline

# Apply update after testing
git pull origin main
cd ../..
git add instructions/ai_instruction_kits
git commit -m "Update instructions to latest version"

Rollback Feature

Instantly revert to previous stable version if issues occur.

Rollback Steps

# Revert to previous version
cd instructions/ai_instruction_kits
git checkout HEAD~1
cd ../..
git add instructions/ai_instruction_kits
git commit -m "Rollback instructions to previous version"

# Revert to specific stable version
cd instructions/ai_instruction_kits
git checkout v1.1.0  # Specific stable version
cd ../..
git add instructions/ai_instruction_kits
git commit -m "Rollback instructions to v1.1.0 (stable)"

📊 Usage Statistics and Metrics

Checkpoint Log Analysis

Quantitatively understand work progress and results.

Basic Statistics

# Total completed tasks
grep "COMPLETE" checkpoint.log | wc -l

# Check running tasks (incomplete)
grep "START" checkpoint.log | grep -v "COMPLETE"

# Today's task list
grep "$(date +%Y-%m-%d)" checkpoint.log

# Extract tasks with errors
grep "ERROR" checkpoint.log

Task Analysis Example

# Script example to calculate time per task ID
#!/bin/bash
while read -r line; do
    if [[ $line =~ \[TASK-([a-f0-9]+)\] ]]; then
        task_id="${BASH_REMATCH[1]}"
        # Find START/COMPLETE pairs and calculate time difference
        # (Implementation details omitted)
    fi
done < checkpoint.log

Project Customization Analysis

Understand project characteristics from PROJECT.md contents:

# Check project settings
cat instructions/PROJECT.md | grep -E "(Build command|Lint command|Test framework)"

# Count customized items
grep -v "^#" instructions/PROJECT.md | grep -v "^$" | grep -v "Example:" | wc -l

Deliverable Quantification

Extract results from checkpoint log:

# Generate deliverable summary
grep "Result:" checkpoint.log | sed 's/.*Result: //' | sort | uniq -c | sort -nr

# Count created files, tests, etc.
grep "Result:" checkpoint.log | grep -E "[0-9]+ (files|tests|endpoints)"

🚀 Future Plans

Planned Features

🤖 AI-powered Instruction Generation

Automatically generate instructions for new categories by learning from existing ones

🔍 Instruction Search and Filtering

Quickly find needed instructions even as they grow

📝 Version Diff Display

Easily understand what changed during updates

🧪 Instruction Testing Framework

Ensure instruction quality

Community Contributions

📚 Learn More