# AI Usage Report

## 1. Tools Used and Use Cases

The main AI tools used during this assignment were:

- ChatGPT / Codex: planning, code review, implementation support, documentation drafting, and debugging.
- AI image generation: creation of the portfolio hero workspace image used in `assets/images/portfolio-workspace.jpg`.

## 2. How AI Was Used

AI support was used during the Assignment 4 upgrade in the following ways:

- reviewing the Assignment 4 instructions and identifying gaps in the Assignment 3 project
- planning how to preserve Assignment 3 functionality while improving the final portfolio
- improving HTML structure, section organization, and user-facing copy
- refining CSS layout, responsive behavior, color tokens, and focus states
- reorganizing JavaScript rendering and validation logic
- improving fallback behavior for GitHub API errors
- drafting README, technical documentation, user guide, and presentation outline
- generating a visual hero image suitable for a professional portfolio

## 3. Benefits

AI helped with:

- converting assignment requirements into a practical implementation checklist
- identifying missing deliverables such as presentation planning and user documentation
- improving code organization and naming consistency
- strengthening accessibility and validation details
- speeding up documentation work while keeping the content aligned with the actual project
- producing a visual asset without relying on external copyrighted images

## 4. Challenges and Limitations

AI assistance had several limitations:

- some suggestions needed to be simplified to fit a small static coursework project
- documentation drafts had to be checked against the actual implemented behavior
- generated UI ideas required manual adjustment to match responsive design constraints
- API behavior still required practical fallback handling because network access can fail
- image generation required review to confirm it was appropriate, professional, and free of logos or readable private text

## 5. Learning Outcomes

Using AI during this assignment helped reinforce:

- how to turn a rubric into concrete implementation tasks
- how to improve an existing project incrementally instead of rebuilding from scratch
- how to separate state, rendering, validation, and data-fetching logic
- how to document AI use transparently for academic integrity
- how to evaluate AI-generated suggestions instead of accepting them blindly
- how to prepare technical explanation for a short project presentation

## 6. Responsible Use and Modifications

AI output was reviewed, edited, and tested before being included. The final project was not submitted as unmodified AI output.

Human review included:

- checking that the features matched the Assignment 4 requirements
- editing code to fit the existing file structure
- replacing vague wording with project-specific documentation
- confirming the app still works as a static website
- reviewing the generated image before referencing it in the page
- keeping the Assignment 3 functionality as the foundation for the final upgrade

## 7. Originality and Academic Integrity

The project remains an original coursework portfolio. AI was used as an assistant for planning, implementation support, documentation, and visual asset creation. The final submission reflects reviewed and modified work, and this report documents where AI assistance was involved.

## 8. Generated Image Details

The hero image was generated with the built-in image generation tool and then optimized from PNG to JPEG for performance.

Final project asset:

```text
assets/images/portfolio-workspace.jpg
```

Prompt summary:

```text
Create a polished editorial-style hero image showing a modern developer workspace for a software engineering student portfolio, with a clean desk, laptop, abstract code editor shapes, notebook sketches, subtle UI wireframes, soft daylight, no people, no readable brand names, no logos, no watermarks, and enough negative space for overlay text.
```