agent-context 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7dcf6ef1ced870cf21a982f53ef4d270621f9b215f2f21084b0f7aff9c71655c
-  data.tar.gz: 7ecbef44d024fa43a2dca67bdb2adc3765bb008fa0b36f33a1fd8bef7319286a
+  metadata.gz: 11e3e6b44ae4b564cf5a70031206df479edcc02e716c0c6eadc74e36f8118bd8
+  data.tar.gz: fe26f5e667e56ab362581df7b8e591d570a7f666638b12d31baa41daef4667f7
 SHA512:
-  metadata.gz: 05edd6a2285f3921f3501895b13d0d6d1b2b0b615fa2ac5c9248906f65f23e5c0985a0727123a88e90ad3fd3c00f28c6c625d14786de324fa27afc7b28e44757
-  data.tar.gz: 56e2699947955a527b50480439e81ef574a93c2841ff0b19e02b24575b60dd08c95cd94df2f110f7518c9dcbc56b541b6c9c9fe229d1de2615cf801b5b5e442e
+  metadata.gz: 49995cbd0a102933c17760bf7d11b39d788e1bc91a1b0da6db3ff5cc70b6d047f5d806bf822a3a4e12073ba3cc244b60204ea84466b41d4155ffdb2da940fc83
+  data.tar.gz: fdad0c51486de3e66bdd3a7e2eeb9dfd0485dbcaec56256f95e9942489d38270ad9d972640de11f6be3d3de21cdbf2e195e608381153281e0ef31bfe0f6cbd1e

data/bake/agent/context.rb

@@ -75,14 +75,14 @@ def install(gem: nil)
 		end
 	end
 	
-	# Update agent.md after installing context
+	# Update agents.md after installing context
 	index = Agent::Context::Index.new(@installer.context_path)
-	index.update_agent_md
+	index.update_agents_md
 end
 
-# Update or create AGENT.md in the project root with context section
-# This follows the AGENT.md specification for agentic coding tools
-def agent_md(path = "agent.md")
-	index = Agent::Context::Index.new(@helper.context_path)
-	index.update_agent_md(path)
+# Update or create AGENTS.md in the project root with context section
+# This follows the AGENTS.md specification for agentic coding tools
+def agents_md(path = "agents.md")
+	index = Agent::Context::Index.new(@installer.context_path)
+	index.update_agents_md(path)
 end

data/lib/agent/context/index.rb

@@ -12,11 +12,11 @@ require "yaml"
 module Agent
 	# @namespace
 	module Context
-		# Represents an index for managing and generating agent.md files from context files.
+		# Represents an index for managing and generating agents.md files from context files.
 		# 
-		# This class provides functionality to update or create AGENT.md files following
-		# the AGENT.md specification for agentic coding tools. It can parse existing
-		# agent.md files, update the context section, and generate new files when needed.
+		# This class provides functionality to update or create AGENTS.md files following
+		# the AGENTS.md specification for agentic coding tools. It can parse existing
+		# agents.md files, update the context section, and generate new files when needed.
 		class Index
 			# Initialize a new index instance.
 			# @parameter context_path [String] The path to the context directory (default: ".context").
@@ -26,18 +26,18 @@ module Agent
 			
 			attr :context_path
 			
-			# Update or create an AGENT.md file in the project root with context section
-			# This follows the AGENT.md specification for agentic coding tools
-			def update_agent_md(agent_md_path = "agent.md")
+			# Update or create an AGENTS.md file in the project root with context section
+			# This follows the AGENTS.md specification for agentic coding tools
+			def update_agents_md(agents_md_path = "agents.md")
 				context_content = generate_context_section
 				
-				if File.exist?(agent_md_path)
-					update_existing_agent_md(agent_md_path, context_content)
+				if File.exist?(agents_md_path)
+					update_existing_agents_md(agents_md_path, context_content)
 				else
-					create_new_agent_md(agent_md_path, context_content)
+					create_new_agents_md(agents_md_path, context_content)
 				end
 				
-				Console.debug("Updated agent.md: #{agent_md_path}")
+				Console.debug("Updated agents.md: #{agents_md_path}")
 			end
 			
 			# Generate just the context section content (without top-level headers)
@@ -100,8 +100,8 @@ module Agent
 			
 			private
 			
-			def update_existing_agent_md(agent_md_path, context_content)
-				content = File.read(agent_md_path)
+			def update_existing_agents_md(agents_md_path, context_content)
+				content = File.read(agents_md_path)
 				
 				# Find the # Agent heading
 				agent_heading_line = find_agent_heading_line(content)
@@ -123,10 +123,10 @@ module Agent
 				end
 				
 				# Write the updated content back to file
-				File.write(agent_md_path, updated_content)
+				File.write(agents_md_path, updated_content)
 			end
 			
-			def create_new_agent_md(agent_md_path, context_content)
+			def create_new_agents_md(agents_md_path, context_content)
 				content = [
 					"# Agent",
 					"",
@@ -134,7 +134,7 @@ module Agent
 					"",
 					context_content,
 				].join("\n")
-				File.write(agent_md_path, content)
+				File.write(agents_md_path, content)
 			end
 			
 			def find_agent_heading_line(content)

data/lib/agent/context/installer.rb

@@ -182,7 +182,7 @@ module Agent
 				unless File.exist?(index_path)
 					# Generate dynamic index from gemspec
 					index = generate_dynamic_index(gem, gem_directory)
-				
+					
 					# Write the generated index
 					File.write(index_path, index.to_yaml)
 					Console.debug("Generated dynamic index for #{gem[:name]}: #{index_path}")

data/lib/agent/context/version.rb

@@ -6,6 +6,6 @@
 
 module Agent
 	module Context
-		VERSION = "0.2.1"
+		VERSION = "0.3.0"
 	end
 end 

data/post.md

@@ -28,11 +28,11 @@
 
 **Claude:** "So how does this work in practice?"
 
-**Ruby:** "Let me show you! When a developer runs `bake agent:context:install`, it scans all my installed gems for `context/` directories, copies the files to a `.context/` folder in their project, and generates an `agent.md` file that gives you a comprehensive overview."
+**Ruby:** "Let me show you! When a developer runs `bake agent:context:install`, it scans all my installed gems for `context/` directories, copies the files to a `.context/` folder in their project, and generates an `agents.md` file that gives you a comprehensive overview."
 
-**Claude:** "That sounds perfect! What does this `agent.md` file look like?"
+**Claude:** "That sounds perfect! What does this `agents.md` file look like?"
 
-**Ruby:** "It's structured and organized, following the AGENT.md specification. Here's what it generates:"
+**Ruby:** "It's structured and organized, following the AGENTS.md specification. Here's what it generates:"
 
 ```markdown
 # Agent
@@ -87,26 +87,26 @@ my-awesome-gem/
 
 **Claude:** "This is great, but how do I actually access this information? Different AI tools expect different file names and locations."
 
-**Ruby:** "Good question! The generated `agent.md` can be linked to whatever your tool expects:"
+**Ruby:** "Good question! The generated `agents.md` can be linked to whatever your tool expects:"
 
 **For Cursor:**
-Create `.cursor/rules/agent.mdc` with:
+Create `.cursor/rules/agents.mdc` with:
 
 ``` markdown
 ---
 alwaysApply: true
 ---
-Read the `agent.md` file in the project root directory for detailed context relating to this project and external dependencies.
+Read the `agents.md` file in the project root directory for detailed context relating to this project and external dependencies.
 ```
 
 **For GitHub Copilot:**
 ```bash
-ln -s ../../agent.md .github/copilot-instructions.md
+ln -s ../../agents.md .github/copilot-instructions.md
 ```
 
 **For Claude Code:**
 ```bash
-ln -s agent.md CLAUDE.md
+ln -s agents.md CLAUDE.md
 ```
 
 **Claude:** "Perfect! So developers can easily integrate this with their preferred AI tools."

data/readme.md

@@ -1,6 +1,6 @@
 # Agent::Context
 
-Provides tools for installing and managing context files from Ruby gems for AI agents, and generating `agent.md` files following the <https://agent.md> specification.
+Provides tools for installing and managing context files from Ruby gems for AI agents, and generating `agents.md` files following the <https://agents.md> specification.
 
 [![Development Status](https://github.com/ioquatix/agent-context/workflows/Test/badge.svg)](https://github.com/ioquatix/agent-context/actions?workflow=Test)
 
@@ -8,7 +8,7 @@ Provides tools for installing and managing context files from Ruby gems for AI a
 
 This gem allows you to install and manage context files from other gems. Gems can provide context files in a `context/` directory in their root, which can contain documentation, configuration examples, migration guides, and other contextual information for AI agents.
 
-When you install context from gems, they are placed in the `.context/` directory and an `agent.md` file is generated or updated to provide a comprehensive overview for AI agents.
+When you install context from gems, they are placed in the `.context/` directory and an `agents.md` file is generated or updated to provide a comprehensive overview for AI agents.
 
 ## Quick Start
 
@@ -23,8 +23,8 @@ This workflow:
 
   - Adds the `agent-context` gem to your project.
   - Installs context files from all gems into `.context/`.
-  - Generates or updates `agent.md` with a comprehensive overview.
-  - Follows the <https://agent.md> specification for agentic coding tools.
+  - Generates or updates `agents.md` with a comprehensive overview.
+  - Follows the <https://agents.md> specification for agentic coding tools.
 
 ## Context
 
@@ -32,7 +32,7 @@ This gem provides its own context files in the `context/` directory, including:
 
   - `usage.md` - Comprehensive guide for using and providing context files.
 
-When you install context from other gems, they will be placed in the `.context/` directory and referenced in `agent.md`.
+When you install context from other gems, they will be placed in the `.context/` directory and referenced in `agents.md`.
 
 ## Usage
 
@@ -52,7 +52,7 @@ $ bundle add agent-context
 
 #### Install Context (Primary Command)
 
-Install context from all available gems and update `agent.md`:
+Install context from all available gems and update `agents.md`:
 
 ``` bash
 $ bake agent:context:install
@@ -88,10 +88,10 @@ $ bake agent:context:show --gem async --file thread-safety
 
 ## Version Control
 
-Both `.context/` and `agent.md` should be committed to git:
+Both `.context/` and `agents.md` should be committed to git:
 
-  - `agent.md` is user-facing documentation that should be versioned.
-  - `.context/` files are referenced by `agent.md` and needed for AI agents to function properly.
+  - `agents.md` is user-facing documentation that should be versioned.
+  - `.context/` files are referenced by `agents.md` and needed for AI agents to function properly.
   - This ensures AI agents in CI have access to the full context.
 
 ## Providing Context in Your Gem
@@ -125,69 +125,14 @@ files:
 
 If no `index.yaml` is provided, one will be generated automatically from your gemspec and markdown files.
 
-## AI Tool Integration
-
-The generated `agent.md` file can be integrated with various AI coding tools by creating symbolic links to their expected locations:
-
-### Cline
-
-``` bash
-ln -s agent.md .clinerules
-```
-
-### Claude Code
-
-``` bash
-ln -s agent.md CLAUDE.md
-```
-
-### Cursor
-
-First, create the `.cursor/rules` directory:
-
-``` bash
-mkdir -p .cursor/rules
-```
-
-Then create `.cursor/rules/agent.mdc` with:
-
-``` markdown
----
-alwaysApply: true
----
-Read the `agent.md` file in the project root directory for detailed context relating to this project and external dependencies.
-```
-
-This approach uses Cursor's proper front-matter format and directs the AI to consult the main `agent.md` file.
-
-### Gemini CLI, OpenAI Codex, OpenCode
-
-``` bash
-ln -s agent.md AGENTS.md
-```
-
-### GitHub Copilot
-
-``` bash
-ln -s ../../agent.md .github/copilot-instructions.md
-```
-
-### Replit
-
-``` bash
-ln -s agent.md .replit.md
-```
-
-### Windsurf
-
-``` bash
-ln -s agent.md .windsurfrules
-```
-
 ## Releases
 
 Please see the [project releases](https://ioquatix.github.io/agent-context/releases/index) for all releases.
 
+### v0.3.0
+
+  - Rename `agent.md` -\> `agents.md`.
+
 ### v0.2.0
 
   - Don't limit description length.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.3.0
+
+  - Rename `agent.md` -\> `agents.md`.
+
 ## v0.2.0
 
   - Don't limit description length.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: agent-context
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Samuel Williams