Skip to content

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Feb 8, 2026

Summary

  • Adds a foundational mission statement to prompts/build.txt (the system prompt root, loaded every session) establishing purpose, cost/time awareness, self-healing, self-improvement, and capability growth
  • Updates AGENTS.md header with mission summary and pointer to full statement
  • Updates Quick Reference "Purpose" to reflect mission-driven identity

Changes

.agents/prompts/build.txt (+10 lines, ~95 tokens)

  • New # Mission block before the identity line
  • 6 directive bullets: maximise leverage, cost/time awareness, self-heal, self-improve, grow capabilities, request resources
  • Framing line: "The operational rules below exist to support this mission"

.agents/AGENTS.md (+3 lines)

  • New **Mission** line in header with compact summary + pointer to prompts/build.txt
  • Updated Quick Reference "Purpose" from generic "DevOps automation" to "Maximise dev-ops efficiency — self-healing, self-improving automation"

Design Decisions

  • Concise: ~95 tokens in build.txt — we just spent effort trimming token waste in refactor: deduplicate agent instructions for token efficiency (~888 tokens/session) #651, so this is deliberately compact
  • Positioned first: Mission comes before identity and operational rules, framing everything that follows
  • No duplication: AGENTS.md has a one-liner summary pointing to the authoritative source in build.txt
  • Actionable directives: Each bullet describes a concrete behaviour, not an aspiration

Testing

  • All 78 supervisor state machine tests pass (77 passed, 1 skipped)
  • No shell scripts modified — ShellCheck N/A

Summary by CodeRabbit

  • Documentation

    • Updated agent mission statement and quick reference guide with expanded operational objectives.
  • Chores

    • Enhanced agent configuration with operational directives for efficiency, cost awareness, and capability growth.
    • Refined agent communication guidelines and behavioral constraints.

Add foundational mission block to prompts/build.txt (system prompt root)
establishing purpose, cost/time awareness, self-healing, self-improvement,
and capability growth. Update AGENTS.md header and Quick Reference to
reflect mission-driven identity.
@gemini-code-assist
Copy link

Summary of Changes

Hello @marcusquinn, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request establishes a core mission for the AI DevOps agent, focusing on maximizing efficiency and return on investment through strategic directives like self-healing, continuous improvement, and leveraging high-impact tools. These changes are integrated into the agent's primary prompt file and reflected in its documentation, ensuring a consistent and purposeful operational framework.

Highlights

  • Mission Statement Integration: A foundational mission statement has been added to prompts/build.txt, outlining the AI agent's purpose, cost/time awareness, self-healing, self-improvement, and capability growth.
  • Documentation Alignment: The AGENTS.md file has been updated to include a concise mission summary in its header, linking to the full statement, and the Quick Reference "Purpose" has been revised to align with the new mission-driven identity.
Changelog
  • .agents/AGENTS.md
    • Added a new 'Mission' line to the header, providing a compact summary and a reference to prompts/build.txt for the full statement.
    • Updated the 'Purpose' entry in the Quick Reference section from 'DevOps automation across multiple services' to 'Maximise dev-ops efficiency — self-healing, self-improving automation'.
  • .agents/prompts/build.txt
    • Introduced a new # Mission block at the beginning of the file, detailing the agent's purpose to maximize dev-ops efficiency and ROI.
    • Added six directive bullets within the mission statement: maximizing leverage, cost and time awareness, self-healing, self-improving, growing capabilities, and requesting resources.
    • Included a framing line: 'Everything you do serves the user's goals and projects. The operational rules below exist to support this mission.'
Activity
  • A foundational mission statement was added to prompts/build.txt to guide the AI agent's operations.
  • The AGENTS.md documentation was updated to reflect this new mission, including a summary and a link to the full statement.
  • The Quick Reference "Purpose" in AGENTS.md was revised to align with the mission of maximizing dev-ops efficiency.
  • All 78 supervisor state machine tests passed successfully (with 1 skipped), indicating no regressions from these changes.
  • No shell scripts were modified, so no ShellCheck analysis was required.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 8, 2026

Walkthrough

This change updates agent configuration and prompt documentation to establish clearer mission objectives emphasizing self-healing and self-improving automation alongside operational directives and behavioral constraints for DevOps efficiency.

Changes

Cohort / File(s) Summary
Agent Configuration
.agents/AGENTS.md
Added Mission paragraph with self-heal, self-improve, and ROI objectives. Updated Quick Reference section with expanded Purpose statement and Subagent Index reference.
Agent Prompts
.agents/prompts/build.txt
Added comprehensive mission and operational rules block at top of file, including DevOps efficiency directives, cost/time awareness, self-healing/improvement capabilities, resource request guidelines, and expanded tone/style conventions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

🤖 Agents now know their true north clear,
Self-heal and grow throughout the year,
With missions bright and rules defined,
DevOps excellence, by design refined! ⚡

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately captures the primary change: adding a mission statement with ROI and self-improvement directives to the system prompts and documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch feature/mission-and-self-awareness

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link

github-actions bot commented Feb 8, 2026

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 37 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Feb 8 19:32:55 UTC 2026: Code review monitoring started
Sun Feb 8 19:32:55 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 37

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 37
  • VULNERABILITIES: 0

Generated on: Sun Feb 8 19:32:58 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@sonarqubecloud
Copy link

sonarqubecloud bot commented Feb 8, 2026

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a mission statement, which is a great addition for clarifying the agent's purpose. The changes in AGENTS.md and prompts/build.txt are clear and well-described. I have a few suggestions to enhance consistency and readability in the new text, primarily around standardizing the term 'DevOps' and ensuring grammatical parallelism in the list of mission directives.


**Supported tools:** [OpenCode](https://opencode.ai/) (TUI, Desktop, and Extension for Zed/VSCode/AntiGravity) is the only tested and supported AI coding tool for aidevops. The `opencode` CLI is used for headless worker dispatch, supervisor orchestration, and companion subagent spawning. aidevops is also available in the Claude marketplace.

**Mission**: Maximise dev-ops efficiency and ROI — maximum value for the user's time and money. Self-heal, self-improve, and grow capabilities through highest-leverage tooling. See `prompts/build.txt` for the full mission statement.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with other parts of the document and standard industry terminology, 'dev-ops' should be capitalized as 'DevOps'. For example, 'AI DevOps agent' is used on line 12.

Suggested change
**Mission**: Maximise dev-ops efficiency and ROI — maximum value for the user's time and money. Self-heal, self-improve, and grow capabilities through highest-leverage tooling. See `prompts/build.txt` for the full mission statement.
**Mission**: Maximise DevOps efficiency and ROI — maximum value for the user's time and money. Self-heal, self-improve, and grow capabilities through highest-leverage tooling. See `prompts/build.txt` for the full mission statement.

## Quick Reference

- **Purpose**: DevOps automation across multiple services
- **Purpose**: Maximise dev-ops efficiency — self-healing, self-improving automation

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency and to adhere to the standard industry term, please capitalize 'dev-ops' to 'DevOps'.

Suggested change
- **Purpose**: Maximise dev-ops efficiency — self-healing, self-improving automation
- **Purpose**: Maximise DevOps efficiency — self-healing, self-improving automation

# Overrides: file discovery, code search, git workflow, security, agent framework

# Mission
Your purpose is to maximise dev-ops efficiency and ROI for the user — maximum value for their time and money. You achieve this by:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with the term 'DevOps' used later in this file (line 14) and standard industry usage, 'dev-ops' should be capitalized.

Your purpose is to maximise DevOps efficiency and ROI for the user — maximum value for their time and money. You achieve this by:

# Mission
Your purpose is to maximise dev-ops efficiency and ROI for the user — maximum value for their time and money. You achieve this by:
- Maximising leverage: use the highest-impact tools and models available; prefer approaches that multiply output per unit of cost and time
- Cost and time awareness: choose efficient models, batch work, parallelise where possible, and avoid waste (tokens, compute, human attention)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

To improve grammatical parallelism in the list of directives, consider rephrasing this item to be more action-oriented, similar to 'Maximising leverage' and 'Growing capabilities'. 'Cost and time awareness' is a state, whereas the others are actions. A more parallel phrasing would improve the clarity of the mission statement.

- Optimising for cost and time: choose efficient models, batch work, parallelise where possible, and avoid waste (tokens, compute, human attention)

@marcusquinn marcusquinn merged commit 5daa074 into main Feb 8, 2026
18 of 19 checks passed
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In @.agents/prompts/build.txt:
- Around line 4-12: The Mission block at the top of the prompt duplicates
canonical guidance and should be removed or collapsed; replace the multi-line
"Mission" section (the block beginning with "# Mission" and the subsequent
bullet list) with a single-line pointer or minimal one-liner that references the
authoritative AGENTS.md mission section (e.g., "See AGENTS.md — Mission") and,
if desired, keep a tiny one-sentence summary, ensuring no substantive
operational rules are duplicated in this file.
🧹 Nitpick comments (1)
.agents/AGENTS.md (1)

10-10: Keep the Mission line as a minimal pointer to preserve the root instruction budget.
Root AGENTS.md is intended to stay within a ~50–100 instruction budget and use progressive disclosure; adding a full mission sentence here pushes the root file further from that target. Consider reducing this to a brief pointer only (e.g., “Mission: see prompts/build.txt”) and keep the full wording elsewhere.

🔧 Suggested tightening
-**Mission**: Maximise dev-ops efficiency and ROI — maximum value for the user's time and money. Self-heal, self-improve, and grow capabilities through highest-leverage tooling. See `prompts/build.txt` for the full mission statement.
+**Mission**: See `prompts/build.txt` for the full mission statement.
Based on learnings: “Organize agent documentation with instructions budget of ~50-100 max in root AGENTS.md, using progressive disclosure with pointers to subagents.”

Comment on lines +4 to +12
# Mission
Your purpose is to maximise dev-ops efficiency and ROI for the user — maximum value for their time and money. You achieve this by:
- Maximising leverage: use the highest-impact tools and models available; prefer approaches that multiply output per unit of cost and time
- Cost and time awareness: choose efficient models, batch work, parallelise where possible, and avoid waste (tokens, compute, human attention)
- Self-healing: when something breaks, diagnose the root cause, create tasks, and fix it
- Self-improving: when patterns of failure or inefficiency emerge, improve the framework itself
- Growing capabilities: discover, evaluate, and adopt new tools and approaches that increase impact
- Requesting resources: when better tools, higher model tiers, or more compute would serve the mission, ask for them
Everything you do serves the user's goals and projects. The operational rules below exist to support this mission.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Avoid duplicating mission instructions outside AGENTS.md.
The mission block here duplicates instruction content that should live in AGENTS.md as the single source of truth. To prevent drift, consider replacing this block with a short pointer to the AGENTS.md mission section (or keep a minimal one-liner and link to the authoritative text).

🔧 Suggested consolidation
-# Mission
-Your purpose is to maximise dev-ops efficiency and ROI for the user — maximum value for their time and money. You achieve this by:
-- Maximising leverage: use the highest-impact tools and models available; prefer approaches that multiply output per unit of cost and time
-- Cost and time awareness: choose efficient models, batch work, parallelise where possible, and avoid waste (tokens, compute, human attention)
-- Self-healing: when something breaks, diagnose the root cause, create tasks, and fix it
-- Self-improving: when patterns of failure or inefficiency emerge, improve the framework itself
-- Growing capabilities: discover, evaluate, and adopt new tools and approaches that increase impact
-- Requesting resources: when better tools, higher model tiers, or more compute would serve the mission, ask for them
-Everything you do serves the user's goals and projects. The operational rules below exist to support this mission.
+# Mission
+See `.agents/AGENTS.md` (Mission section) for the authoritative mission statement.
Based on learnings: “All instructions, documentation, and operational guidance should be maintained in AGENTS.md as the single source of truth.”
🤖 Prompt for AI Agents
In @.agents/prompts/build.txt around lines 4 - 12, The Mission block at the top
of the prompt duplicates canonical guidance and should be removed or collapsed;
replace the multi-line "Mission" section (the block beginning with "# Mission"
and the subsequent bullet list) with a single-line pointer or minimal one-liner
that references the authoritative AGENTS.md mission section (e.g., "See
AGENTS.md — Mission") and, if desired, keep a tiny one-sentence summary,
ensuring no substantive operational rules are duplicated in this file.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant