Skip to content

Comments

feat: support agentic sync without architecture.json (#538)#539

Open
prompt-driven-github[bot] wants to merge 1 commit intomainfrom
change/issue-538
Open

feat: support agentic sync without architecture.json (#538)#539
prompt-driven-github[bot] wants to merge 1 commit intomainfrom
change/issue-538

Conversation

@prompt-driven-github
Copy link
Contributor

Summary

Enable agentic sync (pdd sync <issue-url>) to work on projects that do not have an architecture.json file by scanning the prompts/ directory for module prompt files and building a module catalog for the LLM to select from.

Closes #538

Changes Made

Prompts Modified

  • pdd/prompts/agentic_sync_identify_modules_LLM.prompt — Added conditional logic so the LLM uses architecture.json when available, but falls back to a {module_catalog} (built from prompts/ directory scan) when it is not. Added <pdd-interface> metadata. Made dependency validation conditional (bypass when no architecture.json).

Code Modified

  • pdd/agentic_sync.py — Added logic to scan prompts/ directory for *_*.prompt files (excluding *_LLM.prompt), build a module catalog string, and pass it to the prompt template via the new {module_catalog} placeholder.

Documentation Updated

  • README.md — Added pdd sync to the command listing and documented agentic mode behavior with/without architecture.json
  • docs/TUTORIALS.md — Added "Method 5: Syncing Modules from a GitHub Issue" tutorial section
  • docs/faq.md — Added FAQ entry about using pdd sync without architecture.json

Review Checklist

  • Prompt syntax is valid (placeholders, markers, output format)
  • PDD conventions followed (<pdd-reason>, <pdd-interface> tags)
  • Existing behavior preserved when architecture.json is present
  • Module catalog correctly excludes *_LLM.prompt files
  • Documentation is accurate and up to date

Next Steps After Merge

  1. Regenerate code from modified prompts in dependency order:
    ./sync_order.sh
    Or manually: No modules to sync (prompt-only change)
  2. Run tests to verify functionality
  3. Deploy if applicable

Created by pdd change workflow

Make agentic sync work when a project has no architecture.json by
scanning the prompts/ directory for module prompt files and building
a module catalog. The LLM uses this catalog to identify relevant
modules based on the issue content, with dependencies inferred from
<include> tags in prompt files.

Changes:
- Update agentic_sync_identify_modules_LLM.prompt with conditional
  logic for architecture.json presence/absence and a new
  {module_catalog} placeholder
- Update agentic_sync.py to build module catalog from prompts/ dir
  and pass it to the prompt template
- Update README.md, TUTORIALS.md, and faq.md with documentation

Co-Authored-By: Claude Opus 4 <noreply@anthropic.com>
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.

If the project doesn't have an architecture.json file, agentic sync should still be able to pick up relevant files

1 participant