feat: Improve agent template packaging and documentation

[pmalarme]

This pull request restructures the agent1 agent to use namespace packaging under python_agent_template.agents.agent1, updates the build and test configuration accordingly, and provides improved documentation and Docker support. The changes bring the agent in line with modern Python packaging best practices, making it easier to add new agents, build reproducible containers, and publish packages.

Key changes:

Packaging and Project Structure

• Migrated agent1 to a namespace package under python_agent_template.agents.agent1, following PyPA guidance. This includes moving source files, updating all imports, and removing legacy files (src/agent.py, src/__init__.py). [1] [2] [3] [4]
• Updated pyproject.toml to reflect the new package path, script entrypoint, coverage, and security scan targets. Added [tool.flit.module] for correct wheel metadata. [1] [2] [3]

Docker and Build Improvements

• Added a new Dockerfile that builds a wheel in a builder stage and installs it in a minimal runtime image, ensuring smaller, reproducible containers.

Documentation Enhancements

• Overhauled README.md with updated quickstart, build, test, and publish instructions reflecting the new structure and workflows.
• Added a comprehensive agent guide template in docs/agent-guide-template.md to standardize agent creation and maintenance across the monorepo.

Task and Test Runner Updates

• Updated task definitions and coverage targets to match the new namespace package layout. Improved the shared tasks bundle for agent-scoped and repo-wide checks. [1] [2]

---

References:
[1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11]

[Copilot]

Pull request overview

This pull request modernizes the agent1 package structure to use namespace packaging under python_agent_template.agents.agent1, following PyPA best practices. The refactoring improves package isolation, build reproducibility, and documentation while maintaining all existing functionality.

Changes:

• Migrated to namespace package structure (python_agent_template.agents.agent1) with proper namespace directories (no __init__.py at namespace roots)
• Updated all imports, build configurations, and tool targets to reflect the new package path
• Added comprehensive documentation including a new agent guide template and improved README with quickstart instructions

Reviewed changes

Copilot reviewed 9 out of 11 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
agents/agent1/src/python_agent_template/agents/agent1/agent.py	New location for agent implementation with namespace package structure
agents/agent1/src/python_agent_template/agents/agent1/main.py	Updated CLI entry point with new import paths
agents/agent1/src/python_agent_template/agents/agent1/init.py	New package exports under namespace structure
agents/agent1/src/agent.py	Removed old agent implementation from flat structure
agents/agent1/src/init.py	Removed old package exports from flat structure
agents/agent1/tests/test_agent.py	Updated test imports to use new namespace package paths
agents/agent1/pyproject.toml	Updated script entrypoint, flit module config, and tool targets for new paths
agents/agent1/README.md	Overhauled documentation with new structure and workflows
agents/agent1/Dockerfile	New wheel-based multi-stage build for reproducible containers
docs/agent-guide-template.md	New comprehensive template for creating and maintaining agents
shared_tasks.toml	Simplified build tasks and added check bundle for agent/repo validation

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 9 out of 11 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 9 out of 11 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.