415 lines
10 KiB
Markdown
415 lines
10 KiB
Markdown
# Infinite Variant 6 - File Manifest
|
|
|
|
Complete listing of all files in this variant with descriptions.
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
infinite_variant_6/
|
|
├── .claude/
|
|
│ ├── commands/
|
|
│ │ ├── infinite-stateful.md
|
|
│ │ ├── resume.md
|
|
│ │ ├── status.md
|
|
│ │ └── reset-state.md
|
|
│ ├── settings.json
|
|
│ └── state/
|
|
│ └── README.md
|
|
├── specs/
|
|
│ └── example_spec.md
|
|
├── templates/
|
|
│ ├── run_state.json
|
|
│ ├── url_tracker.json
|
|
│ └── iteration_metadata.json
|
|
├── docs/
|
|
│ └── state_management_guide.md
|
|
├── validators/
|
|
│ └── check_state_consistency.sh
|
|
├── example_output/
|
|
│ ├── visualization_1.html
|
|
│ └── example_state.json
|
|
├── state_manager.py
|
|
├── README.md
|
|
├── CLAUDE.md
|
|
└── MANIFEST.md
|
|
```
|
|
|
|
## File Descriptions
|
|
|
|
### Commands (.claude/commands/)
|
|
|
|
#### infinite-stateful.md
|
|
**Purpose:** Main orchestration command with state management
|
|
**Size:** ~17KB
|
|
**Key Features:**
|
|
- Persistent state in JSON files
|
|
- Self-consistency validation with 6 checks
|
|
- URL deduplication tracking
|
|
- Graceful interruption handling
|
|
- Resume capability
|
|
- Batch-based parallel agent deployment
|
|
- Wave management for infinite mode
|
|
|
|
**Phases:**
|
|
1. State initialization & recovery
|
|
2. Specification analysis
|
|
3. Directory reconnaissance
|
|
4. Iteration planning with state awareness
|
|
5. Parallel agent coordination with state updates
|
|
6. Wave management for infinite mode
|
|
7. Final state validation & reporting
|
|
|
|
#### resume.md
|
|
**Purpose:** Resume interrupted runs
|
|
**Size:** ~3KB
|
|
**Key Features:**
|
|
- Locate and validate state file
|
|
- Pre-resume consistency checks
|
|
- Load original parameters
|
|
- Continue from last iteration
|
|
- Post-resume verification
|
|
|
|
#### status.md
|
|
**Purpose:** View run status and validate consistency
|
|
**Size:** ~5KB
|
|
**Key Features:**
|
|
- List all available runs
|
|
- Detailed run information
|
|
- Self-consistency validation (6 checks)
|
|
- Recent iterations display
|
|
- Resumability status
|
|
- URL usage summary
|
|
- Validation history
|
|
|
|
#### reset-state.md
|
|
**Purpose:** State management utilities
|
|
**Size:** ~6KB
|
|
**Modes:**
|
|
- `--verify`: Check integrity with detailed report
|
|
- `--rebuild`: Reconstruct state from output files
|
|
- `--delete`: Remove state file with backup
|
|
|
|
### Configuration
|
|
|
|
#### .claude/settings.json
|
|
**Purpose:** Tool permissions and custom instructions
|
|
**Size:** ~0.5KB
|
|
**Allowed Tools:**
|
|
- Write, Edit, Read
|
|
- Bash, Task
|
|
- Glob, Grep
|
|
- WebFetch, WebSearch
|
|
|
|
**Custom Instructions:** State management principles
|
|
|
|
### State System
|
|
|
|
#### .claude/state/README.md
|
|
**Purpose:** State system documentation
|
|
**Size:** ~8KB
|
|
**Content:**
|
|
- State file format and schema
|
|
- Field descriptions
|
|
- Status values
|
|
- State operations (read, update, validate)
|
|
- Self-consistency validation explanation
|
|
- Recovery scenarios
|
|
- Best practices
|
|
- File management
|
|
- Troubleshooting
|
|
- Advanced usage
|
|
|
|
### Specifications
|
|
|
|
#### specs/example_spec.md
|
|
**Purpose:** Example specification with state integration
|
|
**Size:** ~7KB
|
|
**Content:**
|
|
- Interactive data visualization requirements
|
|
- File naming pattern
|
|
- Content structure with metadata
|
|
- Real data integration
|
|
- Web learning integration
|
|
- Interactivity requirements
|
|
- Quality standards
|
|
- State management integration
|
|
- Progressive difficulty levels
|
|
- Success criteria
|
|
|
|
### Templates
|
|
|
|
#### templates/run_state.json
|
|
**Purpose:** Template for run state files
|
|
**Size:** ~0.3KB
|
|
**Structure:** Complete state schema with example values
|
|
|
|
#### templates/url_tracker.json
|
|
**Purpose:** Template for URL tracking
|
|
**Size:** ~0.2KB
|
|
**Structure:** URL strategy tracking with difficulty levels
|
|
|
|
#### templates/iteration_metadata.json
|
|
**Purpose:** Template for iteration records
|
|
**Size:** ~0.2KB
|
|
**Structure:** Single iteration metadata structure
|
|
|
|
### Documentation
|
|
|
|
#### docs/state_management_guide.md
|
|
**Purpose:** Comprehensive usage guide
|
|
**Size:** ~21KB
|
|
**Sections:**
|
|
1. Introduction (with self-consistency explanation)
|
|
2. Quick start
|
|
3. Core concepts
|
|
4. State structure
|
|
5. Self-consistency validation
|
|
6. Commands reference
|
|
7. Use cases (4 detailed scenarios)
|
|
8. Best practices
|
|
9. Troubleshooting
|
|
10. Advanced topics
|
|
|
|
### Validators
|
|
|
|
#### validators/check_state_consistency.sh
|
|
**Purpose:** Bash script for state validation
|
|
**Size:** ~6KB
|
|
**Features:**
|
|
- 6 independent validation checks
|
|
- Self-consistency scoring
|
|
- Colored output (pass/fail indicators)
|
|
- Detailed reporting
|
|
- Action recommendations
|
|
- Exit codes based on consistency
|
|
|
|
**Checks:**
|
|
1. Schema validation
|
|
2. File count matching
|
|
3. Iteration record consistency
|
|
4. URL uniqueness
|
|
5. File existence
|
|
6. Timestamp validity
|
|
|
|
### Utilities
|
|
|
|
#### state_manager.py
|
|
**Purpose:** Python utilities for state operations
|
|
**Size:** ~10KB
|
|
**Classes:**
|
|
- `StateManager`: Main state management class
|
|
|
|
**Methods:**
|
|
- `create_run_id()`: Generate new run ID
|
|
- `load_state()`: Load state from file
|
|
- `save_state()`: Save state atomically
|
|
- `create_state()`: Create new state structure
|
|
- `add_iteration()`: Add iteration record
|
|
- `compute_file_hash()`: Compute file hash
|
|
- `validate_consistency()`: Self-consistency validation
|
|
- `rebuild_from_files()`: Reconstruct state
|
|
- `get_next_iteration()`: Determine next iteration
|
|
- `is_url_used()`: Check URL usage
|
|
- `get_available_urls()`: Get unused URLs
|
|
|
|
**CLI Commands:**
|
|
- `list`: List all runs
|
|
- `validate <run_id>`: Validate consistency
|
|
- `info <run_id>`: Show run information
|
|
|
|
### Example Output
|
|
|
|
#### example_output/visualization_1.html
|
|
**Purpose:** Example output demonstrating spec compliance
|
|
**Size:** ~8KB
|
|
**Features:**
|
|
- Self-contained HTML file
|
|
- D3.js visualization (temperature trends)
|
|
- Interactive tooltips
|
|
- Responsive design
|
|
- Embedded metadata for state tracking
|
|
- Web source attribution
|
|
- Techniques learned documentation
|
|
|
|
**Demonstrates:**
|
|
- D3 scales (linear, time)
|
|
- Smooth transitions
|
|
- Interactivity
|
|
- Proper metadata embedding
|
|
- State integration
|
|
|
|
#### example_output/example_state.json
|
|
**Purpose:** Example of actual state file
|
|
**Size:** ~0.8KB
|
|
**Content:**
|
|
- Complete state structure
|
|
- Single iteration record
|
|
- Validation metadata
|
|
- All required fields
|
|
|
|
### Documentation Files
|
|
|
|
#### README.md
|
|
**Purpose:** Project overview and quick start
|
|
**Size:** ~14KB
|
|
**Sections:**
|
|
- Innovation explanation
|
|
- Self-consistency principle
|
|
- Quick start guide
|
|
- Architecture overview
|
|
- Commands reference
|
|
- Usage examples (4 scenarios)
|
|
- Comparison with base loop
|
|
- Self-consistency validation details
|
|
- Extension points
|
|
- Best practices
|
|
- Troubleshooting
|
|
- Use cases
|
|
- Web learning explanation
|
|
|
|
#### CLAUDE.md
|
|
**Purpose:** Instructions for Claude Code
|
|
**Size:** ~9KB
|
|
**Sections:**
|
|
- Project overview
|
|
- Key commands with examples
|
|
- Architecture & structure
|
|
- State management principles (6 principles)
|
|
- Implementation details
|
|
- Usage patterns
|
|
- Best practices (for users, spec authors, command authors)
|
|
- Troubleshooting
|
|
- Web learning integration
|
|
- Extension points
|
|
- Success criteria
|
|
|
|
#### MANIFEST.md
|
|
**Purpose:** This file - complete file listing
|
|
**Size:** ~5KB
|
|
**Content:** Detailed description of every file in variant
|
|
|
|
## File Count Summary
|
|
|
|
- **Total Files:** 18
|
|
- **Commands:** 4
|
|
- **Config:** 1
|
|
- **Documentation:** 5
|
|
- **Templates:** 3
|
|
- **Utilities:** 2
|
|
- **Examples:** 2
|
|
- **Validators:** 1
|
|
|
|
## Total Size Estimate
|
|
|
|
Approximately **110 KB** of content across all files.
|
|
|
|
## Key Technologies
|
|
|
|
- **Languages:** Markdown, Python, Bash, HTML/JavaScript
|
|
- **Frameworks:** D3.js (for examples)
|
|
- **Data Format:** JSON (state files)
|
|
- **Validation:** Multi-method self-consistency
|
|
|
|
## Dependencies
|
|
|
|
### Required
|
|
- Python 3.6+ (for state_manager.py)
|
|
- Bash shell (for validator script)
|
|
- jq (optional, for validator script - Python fallback available)
|
|
|
|
### Optional
|
|
- Modern web browser (for viewing example outputs)
|
|
- D3.js (CDN-loaded, for visualizations)
|
|
|
|
## Usage Workflow
|
|
|
|
1. **Create/Edit Spec** → `specs/example_spec.md`
|
|
2. **Run Loop** → `/infinite-stateful` command
|
|
3. **Monitor** → `/status` command
|
|
4. **Validate** → `check_state_consistency.sh` script
|
|
5. **Resume** → `/resume` command (if needed)
|
|
6. **Rebuild** → `/reset-state --rebuild` (if needed)
|
|
|
|
## State Files Location
|
|
|
|
**Runtime State:** `.claude/state/run_*.json`
|
|
|
|
These files are created during execution and are not included in the repository by default. Each run creates its own state file.
|
|
|
|
## Customization Points
|
|
|
|
### Add Commands
|
|
- Create new `.md` files in `.claude/commands/`
|
|
- Follow existing command structure
|
|
- Update settings.json if needed
|
|
|
|
### Extend State Schema
|
|
- Modify templates in `templates/`
|
|
- Update state_manager.py validation
|
|
- Document changes in `.claude/state/README.md`
|
|
|
|
### Add Validators
|
|
- Create scripts in `validators/`
|
|
- Follow self-consistency principle
|
|
- Document in state_management_guide.md
|
|
|
|
### Custom Specs
|
|
- Create new files in `specs/`
|
|
- Follow example_spec.md structure
|
|
- Ensure metadata embedding
|
|
- Document state integration
|
|
|
|
## Version Information
|
|
|
|
- **Variant Number:** 6
|
|
- **Innovation Focus:** State Management with Self-Consistency
|
|
- **Base Pattern:** Infinite Agentic Loop
|
|
- **Created:** 2025-03-10
|
|
- **Status:** Complete and functional
|
|
|
|
## Learning Applied
|
|
|
|
**Self-Consistency Prompting:**
|
|
- Source: AI prompting research on multiple sampling and majority voting
|
|
- Application: State validation with 6 independent checks
|
|
- Result: High-confidence validation through consensus
|
|
|
|
**Key Insight:** The principle of multiple independent approaches + majority voting generalizes beyond language models to any system requiring reliable validation.
|
|
|
|
## Related Variants
|
|
|
|
This variant builds on the base infinite loop pattern and adds state management. It could be combined with:
|
|
- Web-enhanced variants (for progressive learning)
|
|
- Quality evaluation variants (for output scoring)
|
|
- Template-based variants (for structured generation)
|
|
|
|
## Maintenance
|
|
|
|
### Regular Tasks
|
|
- Clean old state files (30+ days)
|
|
- Backup important runs
|
|
- Validate state consistency
|
|
- Update documentation
|
|
|
|
### State Cleanup
|
|
```bash
|
|
# Remove old states
|
|
find .claude/state -name "run_*.json" -mtime +30 -delete
|
|
|
|
# Backup current states
|
|
tar -czf state_backup.tar.gz .claude/state/
|
|
```
|
|
|
|
## Support
|
|
|
|
For questions or issues:
|
|
1. Review README.md
|
|
2. Check state_management_guide.md
|
|
3. Run validation script
|
|
4. Check .claude/state/README.md
|
|
5. Review CLAUDE.md
|
|
|
|
## License
|
|
|
|
Part of the Infinite Agents project demonstrating Claude Code capabilities.
|