{"record_type":"pith_number_record","schema_url":"https://pith.science/schemas/pith-number/v1.json","pith_number":"pith:2025:ZL6PITRUBA2PYTGRCDD5XZ4UPO","short_pith_number":"pith:ZL6PITRU","schema_version":"1.0","canonical_sha256":"cafcf44e340834fc4cd110c7dbe7947bb417313fd19c10afcd01aafb94867a03","source":{"kind":"arxiv","id":"2511.12884","version":2},"attestation_state":"computed","paper":{"title":"Agent READMEs: An Empirical Study of Context Files for Agentic Coding","license":"http://creativecommons.org/licenses/by/4.0/","headline":"","cross_cats":[],"primary_cat":"cs.SE","authors_text":"Ahmed E. Hassan, Arnon Rungsawang, Bram Adams, Brittany Reid, Bundit Manaskasemsak, Hajimu Iida, Hao Li, Kundjanasith Thonglek, Pattara Leelaprute, Worawalan Chatlatanagulchai, Yutaro Kashiwa","submitted_at":"2025-11-17T02:18:55Z","abstract_excerpt":"Agentic coding tools receive goals written in natural language, break them down into specific tasks, and write or execute code with minimal human intervention. Central to this process are agent context files (e.g., AGENTS.md and CLAUDE.md) that provide persistent, project-level instructions. In this paper, we conduct the first large-scale empirical study of 2,303 agent context files from 1,925 repositories to characterize their structure, maintenance, and content. We find that these files are not static documentation but complex, difficultto-read artifacts that evolve like configuration code t"},"verification_status":{"content_addressed":true,"pith_receipt":true,"author_attested":false,"weak_author_claims":0,"strong_author_claims":0,"externally_anchored":false,"storage_verified":false,"citation_signatures":0,"replication_records":0,"graph_snapshot":true,"references_resolved":false,"formal_links_present":false},"canonical_record":{"source":{"id":"2511.12884","kind":"arxiv","version":2},"metadata":{"license":"http://creativecommons.org/licenses/by/4.0/","primary_cat":"cs.SE","submitted_at":"2025-11-17T02:18:55Z","cross_cats_sorted":[],"title_canon_sha256":"eab7c176b4e852ce86e6283adcd8580724c2c2d81724be9c818e643b3363db3c","abstract_canon_sha256":"614ff0bc8ceba22fef156274a3bfadb858bd341421ddabd3a46662fbc11e0d91"},"schema_version":"1.0"},"receipt":{"kind":"pith_receipt","key_id":"pith-v1-2026-05","algorithm":"ed25519","signed_at":"2026-08-11T01:24:32.505629Z","signature_b64":"IHzsHoBynbJOMSQTpKCaYsaEyrQhx6lD47xbvs6rf8dEIiimdTs9GLxoo7QyvLD1fpWV2HXu46asTuz2iugXCQ==","signed_message":"canonical_sha256_bytes","builder_version":"pith-number-builder-2026-05-17-v1","receipt_version":"0.3","canonical_sha256":"cafcf44e340834fc4cd110c7dbe7947bb417313fd19c10afcd01aafb94867a03","last_reissued_at":"2026-08-11T01:24:32.503185Z","signature_status":"signed_v1","first_computed_at":"2026-08-11T01:24:32.503185Z","public_key_fingerprint":"8d4b5ee74e4693bcd1df2446408b0d54"},"graph_snapshot":{"paper":{"title":"Agent READMEs: An Empirical Study of Context Files for Agentic Coding","license":"http://creativecommons.org/licenses/by/4.0/","headline":"","cross_cats":[],"primary_cat":"cs.SE","authors_text":"Ahmed E. Hassan, Arnon Rungsawang, Bram Adams, Brittany Reid, Bundit Manaskasemsak, Hajimu Iida, Hao Li, Kundjanasith Thonglek, Pattara Leelaprute, Worawalan Chatlatanagulchai, Yutaro Kashiwa","submitted_at":"2025-11-17T02:18:55Z","abstract_excerpt":"Agentic coding tools receive goals written in natural language, break them down into specific tasks, and write or execute code with minimal human intervention. Central to this process are agent context files (e.g., AGENTS.md and CLAUDE.md) that provide persistent, project-level instructions. In this paper, we conduct the first large-scale empirical study of 2,303 agent context files from 1,925 repositories to characterize their structure, maintenance, and content. We find that these files are not static documentation but complex, difficultto-read artifacts that evolve like configuration code t"},"claims":{"count":0,"items":[],"snapshot_sha256":"258153158e38e3291e3d48162225fcdb2d5a3ed65a07baac614ab91432fd4f57"},"source":{"id":"2511.12884","kind":"arxiv","version":2},"verdict":{"id":null,"model_set":{},"created_at":null,"strongest_claim":"","one_line_summary":"","pipeline_version":null,"weakest_assumption":"","pith_extraction_headline":""},"integrity":{"clean":true,"summary":{"advisory":0,"critical":0,"by_detector":{},"informational":0},"endpoint":"/pith/2511.12884/integrity.json","findings":[],"available":true,"detectors_run":[],"snapshot_sha256":"c28c3603d3b5d939e8dc4c7e95fa8dfce3d595e45f758748cecf8e644a296938"},"references":{"count":0,"sample":[],"resolved_work":0,"snapshot_sha256":"258153158e38e3291e3d48162225fcdb2d5a3ed65a07baac614ab91432fd4f57","internal_anchors":0},"formal_canon":{"evidence_count":0,"snapshot_sha256":"258153158e38e3291e3d48162225fcdb2d5a3ed65a07baac614ab91432fd4f57"},"author_claims":{"count":0,"strong_count":0,"snapshot_sha256":"258153158e38e3291e3d48162225fcdb2d5a3ed65a07baac614ab91432fd4f57"},"builder_version":"pith-number-builder-2026-05-17-v1"},"aliases":[{"alias_kind":"arxiv","alias_value":"2511.12884","created_at":"2026-08-11T01:24:32.503928+00:00"},{"alias_kind":"arxiv_version","alias_value":"2511.12884v2","created_at":"2026-08-11T01:24:32.503928+00:00"},{"alias_kind":"doi","alias_value":"10.48550/arxiv.2511.12884","created_at":"2026-08-11T01:24:32.503928+00:00"},{"alias_kind":"pith_short_12","alias_value":"ZL6PITRUBA2P","created_at":"2026-08-11T01:24:32.503928+00:00"},{"alias_kind":"pith_short_16","alias_value":"ZL6PITRUBA2PYTGR","created_at":"2026-08-11T01:24:32.503928+00:00"},{"alias_kind":"pith_short_8","alias_value":"ZL6PITRU","created_at":"2026-08-11T01:24:32.503928+00:00"}],"events":[],"event_summary":{},"paper_claims":[],"inbound_citations":{"count":17,"internal_anchor_count":17,"sample":[{"citing_arxiv_id":"2606.25189","citing_title":"ActPlane: Programmable OS-Level Policy Enforcement for Agent Harnesses","ref_index":7,"is_internal_anchor":true},{"citing_arxiv_id":"2606.25257","citing_title":"How Do Developers Maintain and Evolve Their Agents' Instructions? An Empirical Study","ref_index":9,"is_internal_anchor":true},{"citing_arxiv_id":"2606.20512","citing_title":"Probe-and-Refine Tuning of Repository Guidance for Coding Agents","ref_index":6,"is_internal_anchor":true},{"citing_arxiv_id":"2606.13449","citing_title":"Toward Instructions-as-Code: Understanding the Impact of Instruction Files on Agentic Pull Requests","ref_index":5,"is_internal_anchor":true},{"citing_arxiv_id":"2606.12231","citing_title":"Rule Taxonomy and Evolution in AI IDEs: A Mining and Survey Study","ref_index":23,"is_internal_anchor":true},{"citing_arxiv_id":"2606.25189","citing_title":"ActPlane: Programmable OS-Level Policy Enforcement for Agent Harnesses","ref_index":7,"is_internal_anchor":true},{"citing_arxiv_id":"2607.00911","citing_title":"From Registry to Repository: How AI Agent Skills Are Written, Adapted, and Maintained","ref_index":26,"is_internal_anchor":true},{"citing_arxiv_id":"2604.23822","citing_title":"KISS Sorcar: A Stupidly-Simple General-Purpose and Software Engineering AI Assistant","ref_index":3,"is_internal_anchor":true},{"citing_arxiv_id":"2605.15815","citing_title":"BootstrapAgent: Distilling Repository Setup into Reusable Agent Knowledge","ref_index":7,"is_internal_anchor":true},{"citing_arxiv_id":"2602.14690","citing_title":"Harness Engineering for Agentic AI Coding Tools: An Exploratory Study","ref_index":6,"is_internal_anchor":true},{"citing_arxiv_id":"2603.00822","citing_title":"ContextCov: Deriving and Enforcing Executable Constraints from Agent Instruction Files","ref_index":21,"is_internal_anchor":true},{"citing_arxiv_id":"2604.03196","citing_title":"From Industry Claims to Empirical Reality: An Empirical Study of Code Review Agents in Pull Requests","ref_index":4,"is_internal_anchor":true},{"citing_arxiv_id":"2605.10039","citing_title":"Instruction Adherence in Coding Agent Configuration Files: A Factorial Study of Four File-Structure Variables","ref_index":1,"is_internal_anchor":true},{"citing_arxiv_id":"2605.08435","citing_title":"A Dataset of Agentic AI Coding Tool Configurations","ref_index":3,"is_internal_anchor":true},{"citing_arxiv_id":"2604.23822","citing_title":"KISS Sorcar: A Stupidly-Simple General-Purpose and Software Engineering AI Assistant","ref_index":3,"is_internal_anchor":true},{"citing_arxiv_id":"2605.05584","citing_title":"Operationalizing Ethics for AI Agents: How Developers Encode Values into Repository Context Files","ref_index":4,"is_internal_anchor":true},{"citing_arxiv_id":"2605.04532","citing_title":"Accountable Agents in Software Engineering: An Analysis of Terms of Service and a Research Roadmap","ref_index":10,"is_internal_anchor":true}]},"formal_canon":{"evidence_count":0,"sample":[],"anchors":[]},"links":{"html":"https://pith.science/pith/ZL6PITRUBA2PYTGRCDD5XZ4UPO","json":"https://pith.science/pith/ZL6PITRUBA2PYTGRCDD5XZ4UPO.json","graph_json":"https://pith.science/api/pith-number/ZL6PITRUBA2PYTGRCDD5XZ4UPO/graph.json","events_json":"https://pith.science/api/pith-number/ZL6PITRUBA2PYTGRCDD5XZ4UPO/events.json","paper":"https://pith.science/paper/ZL6PITRU"},"agent_actions":{"view_html":"https://pith.science/pith/ZL6PITRUBA2PYTGRCDD5XZ4UPO","download_json":"https://pith.science/pith/ZL6PITRUBA2PYTGRCDD5XZ4UPO.json","view_paper":"https://pith.science/paper/ZL6PITRU","resolve_alias":"https://pith.science/api/pith-number/resolve?arxiv=2511.12884&json=true","fetch_graph":"https://pith.science/api/pith-number/ZL6PITRUBA2PYTGRCDD5XZ4UPO/graph.json","fetch_events":"https://pith.science/api/pith-number/ZL6PITRUBA2PYTGRCDD5XZ4UPO/events.json","actions":{"anchor_timestamp":"https://pith.science/pith/ZL6PITRUBA2PYTGRCDD5XZ4UPO/action/timestamp_anchor","attest_storage":"https://pith.science/pith/ZL6PITRUBA2PYTGRCDD5XZ4UPO/action/storage_attestation","attest_author":"https://pith.science/pith/ZL6PITRUBA2PYTGRCDD5XZ4UPO/action/author_attestation","sign_citation":"https://pith.science/pith/ZL6PITRUBA2PYTGRCDD5XZ4UPO/action/citation_signature","submit_replication":"https://pith.science/pith/ZL6PITRUBA2PYTGRCDD5XZ4UPO/action/replication_record"}},"created_at":"2026-08-11T01:24:32.503928+00:00","updated_at":"2026-08-11T01:24:32.503928+00:00"}