# Governance Automation Scripts

**Version**: 1.0
**Date**: 2025-01-27
**Purpose**: Automation scripts for governance processes

---

## Available Scripts

### proposal_id_generator.sh

**Purpose**: Generate proposal IDs and create proposal files from template

**Usage**:
```bash
./proposal_id_generator.sh [system]
```

**Examples**:
```bash
# Generate proposal ID and create file
./proposal_id_generator.sh

# Generate proposal ID for specific system
./proposal_id_generator.sh dbis
./proposal_id_generator.sh iccc
./proposal_id_generator.sh smom
```

**What it does**:
1. Generates proposal ID in format: `PROPOSAL-YYYY-MMDD-NNN`
2. Creates proposal file from template
3. Updates placeholder values
4. Places file in `proposals/active/` directory

**Requirements**:
- Template must exist at `../CANONICAL_PROPOSAL_TEMPLATE.md`
- `proposals/active/` directory must exist
- Bash shell with standard utilities

---

## Future Automation Opportunities

### Proposal Tracking
- Automated tracking entry creation
- Status update automation
- Deadline reminder automation

### Compliance Checking
- Pre-submission checklist validation
- Link verification
- Template compliance checking

### Documentation Updates
- Auto-update amendment log (if constitutional)
- Auto-version increment
- Auto-date updates

### Notification Automation
- Automated proposal submission notifications
- Deadline reminder automation
- Status update notifications

---

## Script Development Guidelines

### Standards
- Use bash or appropriate scripting language
- Include error handling
- Provide usage instructions
- Document requirements
- Test scripts before deployment

### Documentation
- Include README for each script
- Document usage examples
- List requirements
- Note any dependencies

---

**Last Updated**: 2025-01-27