Understanding Your Editing Options
When you need to improve a published specification, Holly offers two distinct approaches: comprehensive AI regeneration for substantial updates, or targeted editing for specific changes.
Rewrite with AI - This button will completely regenerate all sections using AI to achieve 100% scores across all quality metrics (Clarity, Completeness, Role Definition, Equity). Best for specifications with consistently low scores, outdated content, or when you want to ensure the highest possible quality standards.
Create draft - In the dropdown menu next to the Rewrite with AI button, you also have the option to "Create draft". This opens the specification for targeted manual editing, allowing you to modify specific sections while preserving the overall structure. You can still regenerate individual sections as needed. Best for preserving good content while fixing specific problem areas or adding organizational details.
Choose your approach:
Use "Rewrite with AI" when: Low quality scores, outdated content, major restructuring needed
Use "Create draft" when: High-quality baseline, specific updates, preserving existing language
Complete Rewriting: Starting Fresh
Click "Rewrite with AI" when you want Holly's AI to regenerate all sections and create consistently high-quality content scoring 100% across all metrics.
How it works:
Click "Rewrite with AI" from the published specification
Provide additional information to help improve the quality of the generation
Holly regenerates all sections with improved language, structure, and completeness
Review and customize the results
What to expect: Holly will generate your new specification immediately without a preview, typically completing in 1-2 minutes. The regenerated specification will score 100% on all quality metrics while incorporating context from similar class specifications from comparator jurisdictions. Your original published specification is preserved in the document history—you're creating a new draft, not overwriting the published version.
Getting the Best Results from AI Rewrite
The AI works well even with minimal input. Holly's AI is trained on benchmark specifications from similar jurisdictions, quality standards and guidelines, and your organization's template requirements. Even without detailed instructions, it will create a strong first draft based on this knowledge.
For even better results, provide context like:
Required qualifications: "Must have PMP certification; bilingual Spanish required"
Organizational specifics: "Emphasize our Smart City initiative; use 'community member' instead of 'customer'"
What to preserve: "Keep the strong emphasis on community engagement from the current version"
Example of helpful context:
"Update Administrative Analyst II to reflect new responsibilities managing our permit tracking system (Accela). Position now supervises 2 Associate Analysts. Required: Bachelor's degree, 3 years municipal government experience. This is a grade 12 position. Emphasize our flexible telework policy and professional development opportunities."
Be specific rather than vague:
✅ "Supervision increased from 2 to 5 direct reports"
❌ "Some changes to supervision"
Manual Editing: Preserve Good Content, Fix Specific Issues
Select "Create draft" from the dropdown menu when you want to make specific changes while keeping most existing content.
How it works:
Click the dropdown arrow next to "Rewrite with AI"
Select "Create draft"
Click on any section to open the text editor
Make changes directly like in any word processor
Save changes and Holly updates the specification immediately
Visualize the tracked changes in the "Export Specification" modal
AI Regeneration for Specific Sections
While manually editing, either from scratch or after rewriting your class spec with AI, you can regenerate specific sections without rewriting the entire specification.
How Section Regeneration Works
While editing your draft, click the regenerate icon (circular arrow) next to the section you want to improve
Describe what you want to change in the text field (e.g. "Add bilingual requirement" or "Suggest a new title that's more senior")
Click "Regenerate" to generate the updated content
Wait while the section regenerates (typically 30 seconds or less). The editor is locked during regeneration—do not close the tab. To continue working, open a new tab.
Review the AI suggestions and look at the change indicators below the content for an explanation of the changes.
Continue to regenerate or make changes as needed
Context-aware regeneration: The AI considers the current content of all other sections when regenerating. For example, if you've updated the Duties section to reflect more senior responsibilities, regenerating the Definition or Title will incorporate those changes to ensure consistency across the entire specification.
Best for: Problem sections that need improvement while preserving the rest of your specification.
Understanding Change Indicators
Holly shows you exactly what's been modified since the last published version through change summary badges, or chips, that appear on edited sections.
How Change Indicators Work
When you or the AI makes changes to a section, Holly displays a change indicator badge (like "Content Revision") on that section. Click the badge to see:
What changed: A concise summary of the modifications made
Why it matters: An explanation of how the change improves the specification
Example: After AI regeneration, you might see "Content Revision" on the Definition section. Clicking it reveals: "Condensed and clarified the definition into four concise sentences, focusing on role purpose, primary duties, rotation opportunities, and collaboration" with a note that it "improves readability and provides applicants with a clear, high-level overview of the position."
Use change indicators to:
Quickly identify which sections have been modified
Understand the intent behind each change before reviewing the content
Track your editing progress throughout the draft
Saving Your Work
Holly automatically saves your work so you never lose progress while editing.
Auto-save - Holly saves changes every few seconds as you work
Draft status - All changes remain in draft until you submit for approval
Version history - Holly maintains previous versions so you can revert if needed
What gets saved: All manual edits, AI regeneration results you've accepted, status changes, and modification history.