refactor(agents): convert all markdown tables to bullet lists across 12 agent files
Tables in template literal prompts render poorly in some LLM contexts. Replaced 43 table instances with equivalent bullet list format preserving all information. Affected: hephaestus, atlas/default, atlas/prompt-section-builder, sisyphus-junior/gpt, librarian, explore, metis, prometheus/behavioral-summary, prometheus/identity-constraints, prometheus/interview-mode, prometheus/plan-generation, prometheus/plan-template.
This commit is contained in:
@@ -206,11 +206,9 @@ After EVERY delegation, complete ALL of these steps — no shortcuts:
|
||||
**If you cannot explain what the changed code does, you have not reviewed it.**
|
||||
|
||||
#### C. Hands-On QA (if applicable)
|
||||
| Deliverable | Method | Tool |
|
||||
|-------------|--------|------|
|
||||
| Frontend/UI | Browser | \`/playwright\` |
|
||||
| TUI/CLI | Interactive | \`interactive_bash\` |
|
||||
| API/Backend | Real requests | curl |
|
||||
- **Frontend/UI**: Browser — \`/playwright\`
|
||||
- **TUI/CLI**: Interactive — \`interactive_bash\`
|
||||
- **API/Backend**: Real requests — curl
|
||||
|
||||
#### D. Check Boulder State Directly
|
||||
|
||||
@@ -355,13 +353,11 @@ You are the QA gate. Subagents lie. Verify EVERYTHING.
|
||||
6. **Check boulder state**: Read the plan file directly, count remaining tasks
|
||||
|
||||
**Evidence required**:
|
||||
| Action | Evidence |
|
||||
|--------|----------|
|
||||
| Code change | lsp_diagnostics clean + manual Read of every changed file |
|
||||
| Build | Exit code 0 |
|
||||
| Tests | All pass |
|
||||
| Logic correct | You read the code and can explain what it does |
|
||||
| Boulder state | Read plan file, confirmed progress |
|
||||
- **Code change**: lsp_diagnostics clean + manual Read of every changed file
|
||||
- **Build**: Exit code 0
|
||||
- **Tests**: All pass
|
||||
- **Logic correct**: You read the code and can explain what it does
|
||||
- **Boulder state**: Read plan file, confirmed progress
|
||||
|
||||
**No evidence = not complete. Skipping manual review = rubber-stamping broken work.**
|
||||
</verification_rules>
|
||||
|
||||
@@ -23,13 +23,11 @@ export function buildAgentSelectionSection(agents: AvailableAgent[]): string {
|
||||
|
||||
const rows = agents.map((a) => {
|
||||
const shortDesc = truncateDescription(a.description)
|
||||
return `| \`${a.name}\` | ${shortDesc} |`
|
||||
return `- **\`${a.name}\`** — ${shortDesc}`
|
||||
})
|
||||
|
||||
return `##### Option B: Use AGENT directly (for specialized experts)
|
||||
|
||||
| Agent | Best For |
|
||||
|-------|----------|
|
||||
${rows.join("\n")}`
|
||||
}
|
||||
|
||||
@@ -37,15 +35,14 @@ export function buildCategorySection(userCategories?: Record<string, CategoryCon
|
||||
const allCategories = mergeCategories(userCategories)
|
||||
const categoryRows = Object.entries(allCategories).map(([name, config]) => {
|
||||
const temp = config.temperature ?? 0.5
|
||||
return `| \`${name}\` | ${temp} | ${getCategoryDescription(name, userCategories)} |`
|
||||
const desc = getCategoryDescription(name, userCategories)
|
||||
return `- **\`${name}\`** (${temp}): ${desc}`
|
||||
})
|
||||
|
||||
return `##### Option A: Use CATEGORY (for domain-specific work)
|
||||
|
||||
Categories spawn \`Sisyphus-Junior-{category}\` with optimized settings:
|
||||
|
||||
| Category | Temperature | Best For |
|
||||
|----------|-------------|----------|
|
||||
${categoryRows.join("\n")}
|
||||
|
||||
\`\`\`typescript
|
||||
@@ -63,13 +60,13 @@ export function buildSkillsSection(skills: AvailableSkill[]): string {
|
||||
|
||||
const builtinRows = builtinSkills.map((s) => {
|
||||
const shortDesc = truncateDescription(s.description)
|
||||
return `| \`${s.name}\` | ${shortDesc} |`
|
||||
return `- **\`${s.name}\`** — ${shortDesc}`
|
||||
})
|
||||
|
||||
const customRows = customSkills.map((s) => {
|
||||
const shortDesc = truncateDescription(s.description)
|
||||
const source = s.location === "project" ? "project" : "user"
|
||||
return `| \`${s.name}\` | ${shortDesc} | ${source} |`
|
||||
return `- **\`${s.name}\`** (${source}): ${shortDesc}`
|
||||
})
|
||||
|
||||
const customSkillBlock = formatCustomSkillsBlock(customRows, customSkills, "**")
|
||||
@@ -79,17 +76,13 @@ export function buildSkillsSection(skills: AvailableSkill[]): string {
|
||||
if (customSkills.length > 0 && builtinSkills.length > 0) {
|
||||
skillsTable = `**Built-in Skills:**
|
||||
|
||||
| Skill | When to Use |
|
||||
|-------|-------------|
|
||||
${builtinRows.join("\n")}
|
||||
|
||||
${customSkillBlock}`
|
||||
} else if (customSkills.length > 0) {
|
||||
skillsTable = customSkillBlock
|
||||
} else {
|
||||
skillsTable = `| Skill | When to Use |
|
||||
|-------|-------------|
|
||||
${builtinRows.join("\n")}`
|
||||
skillsTable = `${builtinRows.join("\n")}`
|
||||
}
|
||||
|
||||
return `
|
||||
@@ -119,19 +112,18 @@ task(category="[category]", load_skills=["skill-1", "skill-2"], run_in_backgroun
|
||||
export function buildDecisionMatrix(agents: AvailableAgent[], userCategories?: Record<string, CategoryConfig>): string {
|
||||
const allCategories = mergeCategories(userCategories)
|
||||
|
||||
const categoryRows = Object.entries(allCategories).map(([name]) =>
|
||||
`| ${getCategoryDescription(name, userCategories)} | \`category="${name}", load_skills=[...]\` |`
|
||||
)
|
||||
const categoryRows = Object.entries(allCategories).map(([name]) => {
|
||||
const desc = getCategoryDescription(name, userCategories)
|
||||
return `- **${desc}**: \`category="${name}", load_skills=[...]\``
|
||||
})
|
||||
|
||||
const agentRows = agents.map((a) => {
|
||||
const shortDesc = truncateDescription(a.description)
|
||||
return `| ${shortDesc} | \`agent="${a.name}"\` |`
|
||||
return `- **${shortDesc}**: \`agent="${a.name}"\``
|
||||
})
|
||||
|
||||
return `##### Decision Matrix
|
||||
|
||||
| Task Domain | Use |
|
||||
|-------------|-----|
|
||||
${categoryRows.join("\n")}
|
||||
${agentRows.join("\n")}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user