Getting Started

Getting Started

Use this path to move from a clean clone to a validated local copy and a first skill inspection.

Prerequisites

• Git
• PowerShell
• Python available as python

The repository validation gate does not currently require a package install.

Clone And Validate

git clone https://github.com/jeremylongworth-source/AgentLogistics.git
cd AgentLogistics
.\scripts\validate-all.ps1

Expected result:

All AgentLogistics validation checks passed.

GitHub Actions runs the same repository validation on pushes, pull requests, and manual dispatches. A separate scheduled and manual workflow audits source links in specialization source maps.

Read In This Order

1. README.md
2. docs/architecture/domain-contract.md
3. docs/architecture/scope-boundaries.md
4. docs/standards/skill-authoring-standard.md
5. docs/standards/research-and-evidence-standard.md
6. docs/standards/calculation-standard.md
7. tests/README.md

First Useful Skill

Start with:

skills/inventory-control/calculate-reorder-point/

It is the reference package for the skill shape and shows the separation between SKILL.md, references, agent metadata, calculations, validation, and tests.

For a role-shaped task, use a package under skillsets/. For jurisdiction, industry, mode, or other source-sensitive work, use a package under specializations/.

Public Release Boundary

AgentLogistics is public, pre-v1, and published as v0.1.0-public-preview for GitHub CLI agent-skill installation. The current v1 audit verdict is V1_PARTIALLY_READY.

Do not treat the repository as a certified logistics, legal, regulatory, engineering, safety, customs, food safety, dangerous-goods, or live-system authority.