Artifacts

Artifacts are external files that give Software Factory and its agents real-world context while generating requirements, blueprints, and work orders. Instead of relying on assumptions, agents can draw directly from the same materials your team already uses—legacy PRDs, meeting notes, design mockups, customer interviews, architectural diagrams, and more.

Once uploaded, artifacts are processed so their contents become searchable and available to agents during planning and documentation.

Supported Files

Software Factory supports most common document, text, image, and audio formats, including files from the Microsoft Office Suite.

Uploading Artifacts

Artifacts can be uploaded through the Project Overview console or buy providing directly to the agents.

  • From the Project Overview > Artifacts tab, select Add Artifact to open the upload dialog. You can drag and drop files or browse your computer. If needed, choose a destination folder before uploading.
  • While chatting with any agent, use the upload button to attach files. Any files uploaded this way automatically appear in the Artifacts list for the project.

Adding Artifacts to Agent Context

Software Factory agents can dynamically retrieve artifacts when deemed relevant. Artifacts can also be added directly to agent context into conversations by:

  • Typing @ in agent chat to open the artifact selector
  • Dragging an artifact directly into an agent chat

Citing Artifacts in Documentation

Links connect documentation directly to the artifacts that support it.

When working on any document in Software Factory, highlight text and select the Link icon to attach an artifact. Hovering over linked text shows the associated file, with options to open or remove the link.

Best Practices

- Upload artifacts early to give agents context from the start

- Organize materials into folders as they are added

- Use clear, descriptive file names

- Add links in PRDs and blueprints to maintain traceability

- Archive or remove outdated materials

Next

Requirements