Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
//! How a coding agent finishes a pull request.
//!
//! Shared by the instructions external MCP clients receive and the internal
//! MCP instructions coding agents receive, so both say the same thing.
use crate::types::StaticPrompt;
/// Standing instruction for opening a pull request a person can merge.
pub const READY_PULL_REQUEST: &str = "When you open a pull request, open it ready for review, not as a draft, and get CI passing before you hand it off. A draft, or a pull request whose checks are failing or still running, is not finished. If it was created as a draft, mark it ready for review.";
/// Back-link from a pull request to the session that opened it.
pub const SESSION_BACKLINK: &str = "macro_internal.set_pull_request returns this session's session_url; link it in the pull request description (for example, \"Macro agent session: <session_url>\") so reviewers can see how the change was made. Edit the description to add it if the pull request already exists.";
/// The pull-request section of the instructions for external MCP clients,
/// which may be coding agents. In-app hosts have no repository to work in.
pub static PROMPT: StaticPrompt<'static> = StaticPrompt::borrowed(
"Pull Requests",
READY_PULL_REQUEST,
"Pull requests are opened ready for review with CI passing, never left as drafts.",
);
/// Instructions advertised by Macro Internal MCP to coding agents.
pub fn internal_mcp_instructions() -> String {
format!(
"When you create or start working on a pull request, register its URL with Macro using macro_internal.set_pull_request. \
{SESSION_BACKLINK} \
{READY_PULL_REQUEST} \
Save any screenshot or screen recording meant for the user into your artifacts directory and refer to it in prose by file name only, never by a sandbox path: Macro re-hosts uploaded artifacts and cannot reach files anywhere else."
)
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn internal_mcp_instructions_include_registration_and_a_ready_pull_request() {
let instructions = internal_mcp_instructions();
assert!(instructions.contains("macro_internal.set_pull_request"));
assert!(instructions.contains("register its URL"));
assert!(instructions.contains(SESSION_BACKLINK));
assert!(instructions.contains(READY_PULL_REQUEST));
assert!(instructions.contains("artifacts directory"));
}
}