Feature/content guidelines

includes/Abilities/Excerpt_Generation/Excerpt_Generation.php

@@ -23,6 +23,15 @@
  */
 class Excerpt_Generation extends Abstract_Ability {
 
+	/**
+	 * {@inheritDoc}
+	 *
+	 * @since x.x.x
+	 */
+	protected function guideline_categories(): array {
+		return array( 'site', 'copy' );
+	}
+
 	/**
 	 * {@inheritDoc}
 	 *

includes/Abilities/Image/Alt_Text_Generation.php

@@ -42,6 +42,15 @@ class Alt_Text_Generation extends Abstract_Ability {
 	 */
 	private const DECORATIVE_ALT_TOKEN = '[[DECORATIVE_ALT]]';
 
+	/**
+	 * {@inheritDoc}
+	 *
+	 * @since x.x.x
+	 */
+	protected function guideline_categories(): array {
+		return array( 'site', 'images' );
+	}
+
 	/**
 	 * {@inheritDoc}
 	 *

includes/Abilities/Image/Generate_Image.php

@@ -27,6 +27,15 @@
  */
 class Generate_Image extends Abstract_Ability {
 
+	/**
+	 * {@inheritDoc}
+	 *
+	 * @since x.x.x
+	 */
+	protected function guideline_categories(): array {
+		return array( 'site', 'images' );
+	}
+
 	/**
 	 * {@inheritDoc}
 	 *
@@ -244,6 +253,14 @@ private function get_prompt_builder( string $prompt, ?string $reference_image =
 			->as_output_file_type( FileTypeEnum::inline() )
 			->using_model_preference( ...get_preferred_image_models() );
 
+		// Inject guidelines as a system instruction to match other abilities.
+		$guidelines = $this->get_guidelines_for_prompt();
+		if ( $guidelines ) {
+			$instruction  = 'The following guidelines represent the site's editorial standards. Apply them where relevant. Do not fabricate content to satisfy guidelines. If guidelines conflict with the input, prioritize accuracy.';
+			$instruction .= "\n\n" . $guidelines;
+			$prompt_builder->using_system_instruction( $instruction );
+		}
+
 		if ( null !== $reference_image ) {
 			try {
 				$file           = new File( $reference_image );

includes/Abilities/Image/Generate_Image_Prompt.php

@@ -23,6 +23,15 @@
  */
 class Generate_Image_Prompt extends Abstract_Ability {
 
+	/**
+	 * {@inheritDoc}
+	 *
+	 * @since x.x.x
+	 */
+	protected function guideline_categories(): array {
+		return array( 'site', 'images' );
+	}
+
 	/**
 	 * {@inheritDoc}
 	 *

includes/Abilities/Review_Notes/Review_Notes.php

@@ -38,7 +38,16 @@ class Review_Notes extends Abstract_Ability {
 	 * @var list<string>
 	 */
 	// phpcs:ignore SlevomatCodingStandard.Classes.DisallowMultiConstantDefinition.DisallowedMultiConstantDefinition
-	protected const SUPPORTED_REVIEW_TYPES = array( 'accessibility', 'readability', 'grammar', 'seo' );
+	protected const SUPPORTED_REVIEW_TYPES = array( 'accessibility', 'readability', 'grammar', 'seo', 'guidelines' );
+
+	/**
+	 * {@inheritDoc}
+	 *
+	 * @since x.x.x
+	 */
+	protected function guideline_categories(): array {
+		return array( 'site', 'copy', 'additional' );
+	}
 
 	/**
 	 * {@inheritDoc}
@@ -292,7 +301,7 @@ protected function generate_review(
 	) {
 		$prompt = $this->create_prompt( $block_type, $block_content, $context, $existing_notes, $review_types );
 
-		$prompt_builder = $this->get_prompt_builder( $prompt );
+		$prompt_builder = $this->get_prompt_builder( $prompt, $block_type );
 
 		if ( is_wp_error( $prompt_builder ) ) {
 			return $prompt_builder;
@@ -357,11 +366,12 @@ protected function generate_review(
 	 * @since 0.7.0
 	 *
 	 * @param string $prompt The prompt to generate review notes from.
+	 * @param string $block_type The block type identifier.
 	 * @return \WP_AI_Client_Prompt_Builder|\WP_Error The prompt builder, or a WP_Error on failure.
 	 */
-	private function get_prompt_builder( string $prompt ) {
+	private function get_prompt_builder( string $prompt, string $block_type ) {
 		$prompt_builder = wp_ai_client_prompt( $prompt )
-			->using_system_instruction( $this->get_system_instruction() )
+			->using_system_instruction( $this->get_system_instruction( null, array( 'block_name' => $block_type ) ) )
 			->using_model_preference( ...get_preferred_models_for_text_generation() )
 			->as_json_response( $this->suggestions_schema() );
 

includes/Abilities/Review_Notes/system-instruction.php

@@ -86,4 +86,8 @@
 - grammar: Flag clear grammar issues in the quoted text itself
 
 For all other block types, apply readability, and grammar checks if text content is present.
+
+## Guidelines Review
+
+If guidelines are provided in <guidelines> tags, evaluate the block content against these guidelines. Flag material violations of the editorial standards as suggestions with review_type "guidelines". Only flag clear, objective violations — not minor style preferences. If block-specific guidelines are provided, prioritize those over general guidelines for the block being reviewed.
 INSTRUCTION;

includes/Abilities/Summarization/Summarization.php

@@ -32,6 +32,15 @@ class Summarization extends Abstract_Ability {
 	 */
 	protected const LENGTH_DEFAULT = 'medium';
 
+	/**
+	 * {@inheritDoc}
+	 *
+	 * @since x.x.x
+	 */
+	protected function guideline_categories(): array {
+		return array( 'site', 'copy' );
+	}
+
 	/**
 	 * {@inheritDoc}
 	 *

includes/Abilities/Title_Generation/Title_Generation.php

@@ -23,6 +23,15 @@
  */
 class Title_Generation extends Abstract_Ability {
 
+	/**
+	 * {@inheritDoc}
+	 *
+	 * @since x.x.x
+	 */
+	protected function guideline_categories(): array {
+		return array( 'site', 'copy' );
+	}
+
 	/**
 	 * {@inheritDoc}
 	 *

includes/Abstracts/Abstract_Ability.php

@@ -13,6 +13,8 @@
 use WP_Ability;
 use WP_Error;
 
+use function WordPress\AI\format_guidelines_for_prompt;
+
 /**
  * Base implementation for a WordPress Ability.
  *
@@ -102,20 +104,81 @@ abstract protected function permission_callback( $input );
 	 */
 	abstract protected function meta(): array;
 
+	/**
+	 * Returns the guideline categories this ability uses.
+	 *
+	 * Override in subclasses to opt into guidelines.
+	 * Return an empty array to skip guidelines (default).
+	 *
+	 * Valid categories: 'site', 'copy', 'images', 'additional'.
+	 *
+	 * @since x.x.x
+	 *
+	 * @return list<string> Guideline category slugs.
+	 */
+	protected function guideline_categories(): array {
+		return array();
+	}
+
+	/**
+	 * Returns formatted guidelines for prompt injection.
+	 *
+	 * Uses guideline_categories() to determine which categories to include.
+	 * Unsupported categories are silently dropped.
+	 * Returns empty string when guidelines are unavailable or no categories declared.
+	 *
+	 * @since x.x.x
+	 *
+	 * @param string|null $block_name Optional block name for block-specific guidelines.
+	 * @return string Formatted guidelines XML string, or empty string.
+	 */
+	protected function get_guidelines_for_prompt( ?string $block_name = null ): string {
+		$categories = array_values(
+			array_intersect(
+				$this->guideline_categories(),
+				array( 'site', 'copy', 'images', 'additional' )
+			)
+		);
+		if ( empty( $categories ) ) {
+			return '';
+		}
+		return format_guidelines_for_prompt( $categories, $block_name );
+	}
+
 	/**
 	 * Gets the system instruction for the feature.
 	 *
+	 * When guideline_categories() returns a non-empty array and guidelines are
+	 * available, automatically appends them to the system instruction.
+	 *
+	 * Supports a reserved `block_name` key in `$data` for block-specific guidelines.
+	 *
 	 * @since 0.1.0
 	 *
-	 * @param string|null            $filename Optional. Explicit filename to load. If not provided,
-	 *                                         attempts to load `system-instruction.php` or `prompt.php`.
-	 * @param array<string, mixed>   $data     Optional. Data to expose to the system instruction file.
-	 *                                         This data will be extracted as variables available in the file scope.
+	 * @param string|null            $filename   Optional. Explicit filename to load. If not provided,
+	 *                                           attempts to load `system-instruction.php` or `prompt.php`.
+	 * @param array<string, mixed>   $data       Optional. Data to expose to the system instruction file.
+	 *                                           This data will be extracted as variables available in the file scope.
 	 * @return string The system instruction for the feature.
 	 */
 	public function get_system_instruction( ?string $filename = null, array $data = array() ): string {
+		$block_name = null;
+		if ( isset( $data['block_name'] ) && is_string( $data['block_name'] ) ) {
+			$block_name = $data['block_name'];
+			unset( $data['block_name'] );
+		}
+
 		$instruction = $this->load_system_instruction_from_file( $filename, $data );
 
+		if ( '' !== $instruction && ! empty( $this->guideline_categories() ) ) {
+			$guidelines = $this->get_guidelines_for_prompt( $block_name );
+
+			if ( $guidelines ) {
+				$instruction .= "\n\n" . 'The following guidelines represent the site&#039;s editorial standards. Apply them where relevant. Do not fabricate content to satisfy guidelines. If guidelines conflict with the input, prioritize accuracy.';
+				$instruction .= "\n\n" . $guidelines;
+			}
+		}
+
 		/**
 		 * Filters the system instruction for an ability.
 		 *