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 provided directly to agents.

• From Project Overview → Artifacts, select Add Artifact to open the upload dialog. 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. Files uploaded this way automatically appear in the project’s Artifacts list.

Adding Artifacts to Agent Context

Software Factory agents can dynamically retrieve artifacts when they are relevant. You can also add artifacts directly to a conversation’s agent context 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.