docs: add workspace reference for agentic coding

Update AGENTS.md and README.md to direct AI-assisted development
to use the halos-distro workspace for full context across all repos.

This follows the pattern established in cockpit-apt PR #51, ensuring
Claude Code and other AI assistants have access to complete workspace
documentation and development workflows.

See halos-distro/docs/ for:
- HUMAN_DEVELOPMENT_GUIDANCE.md
- IMPLEMENTATION_CHECKLIST.md
- DEVELOPMENT_WORKFLOW.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: mairas

AGENTS.md

@@ -0,0 +1,40 @@
+⚠️ **THESE RULES ONLY APPLY TO FILES IN /apt.hatlabs.fi/** ⚠️
+
+# Hat Labs APT Repository - Development Guide
+
+## 🎯 For Agentic Coding: Use the HaLOS Workspace
+
+This repository should be used as part of the halos-distro workspace for AI-assisted development:
+
+```bash
+# Clone workspace and all repos
+git clone https://github.com/hatlabs/halos-distro.git
+cd halos-distro
+./run repos:clone
+```
+
+See `halos-distro/docs/` for development workflows and guidance.
+
+## About This Project
+
+APT repository infrastructure for Hat Labs packages and tools.
+
+**Local Instructions**: For environment-specific instructions and configurations, see @CLAUDE.local.md (not committed to version control).
+
+## Git Workflow Policy
+
+**Branch Workflow:** Never push to main directly - always use feature branches and PRs.
+
+## Repository Structure
+
+This repository maintains the Hat Labs APT repository at https://apt.hatlabs.fi.
+
+- **scripts/**: Repository management scripts
+- **docs/**: Documentation
+- **.github/workflows/**: CI/CD automation
+- **gh-pages branch**: Published APT repository content
+
+## Related
+
+- **Parent**: [../AGENTS.md](../AGENTS.md) - Workspace documentation
+- **Packages**: Built from halos-marine-containers, cockpit-apt, runtipi-docker-service, etc.

README.md

@@ -1,3 +1,24 @@
 # Hat Labs APT repository
 
 This is the APT repository for Hat Labs. It contains packages and tools for use with our systems.
+
+## Agentic Coding Setup (Claude Code, GitHub Copilot, etc.)
+
+For development with AI assistants, use the halos-distro workspace for full context:
+
+```bash
+# Clone the workspace
+git clone https://github.com/hatlabs/halos-distro.git
+cd halos-distro
+
+# Get all sub-repositories including apt.hatlabs.fi
+./run repos:clone
+
+# Work from workspace root for AI-assisted development
+# Claude Code gets full context across all repos
+```
+
+See `halos-distro/docs/` for development workflows:
+- `HUMAN_DEVELOPMENT_GUIDANCE.md` - Quick start guide
+- `IMPLEMENTATION_CHECKLIST.md` - Development checklist
+- `DEVELOPMENT_WORKFLOW.md` - Detailed workflows