Skip to content

chore: add AI Week golden path artifacts (L1 + L2)#216

Open
fdaciuk wants to merge 3 commits into
masterfrom
ai-week/golden-path-setup
Open

chore: add AI Week golden path artifacts (L1 + L2)#216
fdaciuk wants to merge 3 commits into
masterfrom
ai-week/golden-path-setup

Conversation

@fdaciuk

@fdaciuk fdaciuk commented May 15, 2026

Copy link
Copy Markdown

Summary

  • Adds AGENTS.md with detailed agent context for this VTEX IO app: purpose, stack, directory structure, verified commands, architectural constraints, VTEX IO-specific patterns, expected skills, and autonomy limits
  • Adds CLAUDE.md as a symlink to AGENTS.md (read by Claude Code)
  • Adds root README.md with setup, test, and publish instructions
  • Initializes spec-kit (specify init --integration claude) with a filled constitution.md covering VTEX IO platform constraints, public API stability rules, CSS Handles policy, i18n completeness, and quality gates
  • Adds SDD Lite skills (/specification, /implementing) from vtex-agent-skills to .agents/skills/
  • Adds SDD Full skills (14 speckit-* skills) to .agents/skills/
  • Wires .claude/skills, .claude/commands, and .claude/rules as symlinks to .agents/ subfolders for portability

AI Standards Level

Before After
L0 — No AI files L2 — Golden Path Setup (SDD Full + SDD Lite)

Test plan

  • Verify CLAUDE.md is a valid symlink to AGENTS.md
  • Verify .claude/skills resolves to .agents/skills/ and lists all 16 skills
  • Verify /specification and /implementing skills are available in Claude Code
  • Verify speckit-* skills are available in Claude Code
  • Verify .specify/memory/constitution.md reflects real project constraints

fdaciuk added 2 commits May 15, 2026 14:28
- AGENTS.md: detailed agent context for VTEX IO order-placed app
- CLAUDE.md: symlink to AGENTS.md for Claude Code
- README.md: root readme with setup, test, and publish instructions
- .specify/: spec-kit initialized with Claude integration and project constitution
- .agents/skills/: spec-kit SDD Full skills (14 speckit-* skills)
- .claude/: symlinks to .agents/ subfolders (skills, commands, rules)
@fdaciuk fdaciuk requested a review from a team as a code owner May 15, 2026 17:48
@fdaciuk fdaciuk requested review from evertonstrack and guilhermedias-bit and removed request for a team May 15, 2026 17:48
@vtex-io-ci-cd

vtex-io-ci-cd Bot commented May 15, 2026

Copy link
Copy Markdown
Contributor

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 😞

@vtex-io-docs-bot

Copy link
Copy Markdown

Beep boop 🤖

I noticed you didn't make any changes at the docs/ folder

  • There's nothing new to document 🤔
  • I'll do it later 😞

In order to keep track, I'll create an issue if you decide now is not a good time

  • I just updated 🎉🎉

if isinstance(meta, dict) and meta.get('enabled', True) is not False:
print(pid)
except Exception:
sys.exit(1)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if isinstance(meta, dict) and meta.get('enabled', True) is not False:
print(pid)
except Exception:
sys.exit(1)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

except ImportError:
print('yaml_missing', file=sys.stderr)
print('replace\t')
sys.exit(0)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

for t in data.get('provides', {}).get('templates', []):
if t.get('name') == os.environ['SPECKIT_TMPL'] and t.get('type', 'template') == 'template':
print(t.get('strategy', 'replace') + '\t' + t.get('file', ''))
sys.exit(0)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@github-actions

github-actions Bot commented May 15, 2026

Copy link
Copy Markdown
Fails
🚫

We follow keepachangelog standards.

Please, change the file CHANGELOG.md adding a small summary of your changes under the [Unreleased] section. Example:

 ## [Unreleased]

+ ### Fixed
+ - Issue with image sizing in the SKU Selector.

Possible types of changes:

  • Added for new features.
  • Changed for changes in existing functionality.
  • Deprecated for soon-to-be removed features.
  • Removed for now removed features.
  • Fixed for any bug fixes.
  • Security in case of vulnerabilities.
Warnings
⚠️

👀 The size of this pull request seems relatively large (>420 modifications). Consider splitting it into smaller pull requests to help make reviews easier and faster.

Generated by 🚫 dangerJS against d1622af

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant