Files
automation/README.md
2026-02-09 21:51:44 -08:00

86 lines
1.8 KiB
Markdown

# 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