docs(ai): bootstrap AI Week artifacts (L1-L3)

[iagolaguna]

Summary

Bootstrap of the AI Week documentation artifacts so this repo passes Step 1 of the AI Week PR review (L1 + L1.5 + L1.7 + L2 fully PASS, L3 PASS by reference because the repo is public).

All docs are written in English. No application code changed — this PR is documentation only.

What was added

• AGENTS.md — operational source of truth for AI agents and new engineers. Contains the 4 mandatory sections (Sources of truth, Verified commands, Expected skills, Autonomy limits) plus a Golden Path mode declaration (Full SDD, with Lite-only allowed for hotfixes).
• CLAUDE.md — relative symlink → AGENTS.md (no content duplication).
• .specify/memory/constitution.md — project constitution v1.0.0 with 5 binding principles (backward-compatible public API, tested behavior, i18n, performance budget, side-effect free utils) and a Governance section.
• .agents/skills/ — 12 skills with valid frontmatter:
  • Core SDD: specification, implementing
  • SpecKit (10): speckit-constitution, speckit-specify, speckit-plan, speckit-tasks, speckit-implement, speckit-analyze, speckit-clarify, speckit-checklist, speckit-git-feature, speckit-git-commit
• .agents/commands/ and .agents/rules/ — placeholders with .gitkeep (convention).
• .claude/{skills,commands,rules} — relative symlinks bridging to .agents/* so Claude Code can read them out of the box.
• .specify/templates/ — 5 SDD templates (constitution, spec, plan, tasks, checklist).
• .specify/scripts/bash/ — 6 helper scripts: common.sh, create-new-feature.sh, setup-plan.sh, setup-tasks.sh, check-prerequisites.sh, update-agent-context.sh.
• .gitignore — adds /specs and .specify/feature.json (SpecKit local-only paths).

AI Week review status

Re-running the review checklist on this branch produces:

L1   ✅ PASS   AGENTS.md committed + 4 sections + CLAUDE.md symlink + .agents/ structure + .claude bridges
L1.5 ✅ PASS   .gitignore covers /specs and .specify/feature.json (and nothing leaked)
L1.7 ✅ PASS   AGENTS.md references constitution.md and lists the expected skills
L2   ✅ PASS   constitution v1.0.0 with no placeholders, 5 templates, 6 scripts, 10 speckit-* skills
L3   ✅ PASS by reference   public repo, AGENTS.md links to internal Confluence (CHK space)

TOTAL: PASS=41 | FAIL=0 | PARTIAL=0

Test plan

• git ls-tree HEAD AGENTS.md CLAUDE.md returns both files (regular file + symlink mode 120000)
• git show HEAD:CLAUDE.md returns the string AGENTS.md
• .claude/{skills,commands,rules} are relative symlinks that resolve to .agents/*
• .specify/memory/constitution.md has no [PLACEHOLDER] patterns
• All 12 SKILL.md files have valid YAML frontmatter (name:, description:)
• .specify/scripts/bash/check-prerequisites.sh exits 0 from the repo root
• CI checks pass (lint, tests, SonarQube — Step 2 scope)

Out of scope

• Application code (react/) — untouched.
• package.json, manifest.json, CI config — untouched.
• README and product docs — Step 2 will cover these.

🤖 Generated with Claude Code

[vtex-io-ci-cd]

Hi! I'm VTEX IO CI/CD Bot and I'll be helping you to publish your app! 🤖

Please select which version do you want to release:

• Patch (backwards-compatible bug fixes)

• Minor (backwards-compatible functionality)

• Major (incompatible API changes)

And then you just need to merge your PR when you are ready! There is no need to create a release commit/tag.

• No thanks, I would rather do it manually 😞